> For the complete documentation index, see [llms.txt](https://docs.febucci.com/text-animator-unity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.febucci.com/text-animator-unity/2.x-zh/xiao-guo/wei-ni-de-wen-ben-tian-jia-xiao-guo.md).

# 为你的文本添加效果

## 类别概览 <a href="#effects-categories" id="effects-categories"></a>

效果根据其功能/应用分为三类。它们包括：

<table data-view="cards"><thead><tr><th align="center"></th><th></th><th></th></tr></thead><tbody><tr><td align="center"><strong>行为效果</strong> </td><td><img src="/files/a0cb2a22969b8ede742381102babb7f329bb422b" alt="An example of the Behavior Effect <wiggle>" data-size="original"></td><td>行为效果在字母可见时持续对其进行动画处理。</td></tr><tr><td align="center"><strong>出现效果</strong>   </td><td><img src="/files/3de365856ff0465045c9148682eaa5e7e2bba8bc" alt="An example of the Appearance Effect {vertexp}" data-size="original"></td><td>出现效果仅在字母出现在屏幕上时对其进行动画处理。因此，它们通常与打字机效果结合使用，后者按顺序显示字母。</td></tr><tr><td align="center"><strong>消失效果</strong> </td><td><img src="/files/510985290952c3c0304110725411ba5258af086a" alt="An example of the Disappearance Effect {#size}" data-size="original"></td><td>消失效果在字母刚变为不可见时对其进行动画处理，本质上它们只是反向的出现效果。</td></tr></tbody></table>

{% hint style="info" %}
这里提供了内置效果的列表： [内置效果列表](/text-animator-unity/2.x-zh/xiao-guo/nei-zhi-xiao-guo-lie-biao.md)
{% endhint %}

***

## 如何应用效果 <a href="#how-to-apply-effects" id="how-to-apply-effects"></a>

你可以通过两种主要方式为文本设置不同的效果：

* [#set-default-effects-to-the-entire-text](#set-default-effects-to-the-entire-text "mention") （检查器）
* [#set-effects-to-specific-parts-of-the-text](#set-effects-to-specific-parts-of-the-text "mention") （富文本标签）

### 为整个文本设置默认效果 <a href="#set-default-effects-to-the-entire-text" id="set-default-effects-to-the-entire-text"></a>

你可以在 TextAnimator 组件中设置默认将应用于所有字母的效果， **无需为每段文本编写效果标签**.

1. 前往 TextAnimator 组件并查看“默认标签”部分

   <img src="/files/9b40e6a2198daf897e1ffb6de0cafef2e195bdf5" alt="文本动画器默认标签概览" width="600">
2. 展开你要编辑的效果类别
3. 添加你想包含的任何效果标签，例如：

{% hint style="info" %}
&#x20;如果你不想默认应用任何效果，只需将效果数量设置为零。
{% endhint %}

{% hint style="success" %}
你也可以更改“**默认标签模式**”为“**持续**”如果你希望效果始终应用，并叠加在所有内容之上。
{% endhint %}

{% hint style="success" %}
你可以为每个数组元素添加修饰符，例如“shake a=5”，更多信息请阅读： [修饰符](/text-animator-unity/2.x-zh/xiao-guo/wei-ni-de-wen-ben-tian-jia-xiao-guo/xiu-shi-fu.md)
{% endhint %}

### 为文本的特定部分设置效果 <a href="#set-effects-to-specific-parts-of-the-text" id="set-effects-to-specific-parts-of-the-text"></a>

你可以使用富文本标签将效果应用于文本的特定部分，覆盖默认标签（如果存在“回退”）。

效果标签看起来像这样：

* **行为**: `<tag>` 用于打开， `</tag>` 用于关闭
* **出现**: `{tag}` 用于打开， `{/tag}` 用于关闭
* **消失**: `{#tag}` 用于打开， `{/#tag}` 用于关闭\
  \&#xNAN;*（基本上是在前面加了一个 `#` 以简单提醒你，消失效果是出现效果的反向）*.

{% hint style="info" %}
一旦你关闭效果标签，字母将再次受到默认效果的影响（如果设置了“回退”）。
{% endhint %}

{% hint style="danger" %}
请注意，不要使用 TMPro 的右侧文本标签格式！
{% endhint %}

<details>

<summary>示例 1：简单效果</summary>

示例：“`我很冷`” 可以写为 “`I'm <shake>cold</shake>`”（在文本组件中）以便对特定单词 “cold” 应用 *抖动* 行为效果。

<img src="/files/cf358fe3d2909e49874c82c00752af802c016c78" alt="Untitled" data-size="original">

</details>

<details>

<summary>示例 2：回退</summary>

假设我们有一个默认效果（“size”），但我们想对文本的特定部分应用“fade”效果。\
我们可以通过写："default default \`{fade}\` fade fade fade \`{/fade}\` default default" 来实现该结果

![](/files/8ca91addde5c94b83b49b9655d20b3b77477c3f7)

如你所见，位于 “fade” 标签外的字母将应用默认效果，而位于 “{fade}” 和 “{/fade}” 之间的部分将仅具有“fade”。

</details>

***

### 关于富文本格式的补充说明 <a href="#extra-notes-about-rich-text-formatting" id="extra-notes-about-rich-text-formatting"></a>

使用 TextAnimator for Unity：

* 你可以将多个效果堆叠在一起（例如“`<shake><size>`”）。\
  （另请查看 [样式](/text-animator-unity/2.x-zh/xiao-guo/wei-ni-de-wen-ben-tian-jia-xiao-guo/yang-shi.md))
* 你可以使用一个字符关闭 **所有** 当前打开的效果，使用一个‘`/`’字符，例如：
  * ”`</>`” 对于行为效果
  * ”`{/}`” 对于出现效果
  * ”`{/#}`” 对于消失效果。
* 如果你位于文本末尾，则无需关闭标签，因为 Text Animator 从你打开标签的那一刻起就开始应用效果。（例如 "`<shake>hello`" 将导致 hello 已经开始动画）。