# 为你的文本添加效果

## 类别概览 <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 已经开始动画）。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.febucci.com/text-animator-unity/2.x-zh/xiao-guo/wei-ni-de-wen-ben-tian-jia-xiao-guo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.