Rich Text

The text for UI elements and text meshes can incorporate multiple font styles and sizes. Rich text is supported both for the UI System and the legacy GUI system. The Text, GUIStyle, GUIText and TextMesh classes have a Rich Text setting which instructs Unity to look for markup tags within the text. The Debug.Log function can also use these markup tags to enhance error reports from code. The tags are not displayed but indicate style changes to be applied to the text.

UI 元素和文本网格的文本可以合并多个字体样式和大小。对 UI 系统和传统的 GUI 系 统都支持富文本。Text、 GUIStyle、 GUIText 和 TextMesh 的类有丰富文本设置指导 unity 寻 找 tags 标记的文本。Debug.Log 函数也可以使用这些标记来提高代码的错误报告。tags 不会 显示，但显示样式的更改会应用于文本

Markup format

The markup system is inspired by HTML but isn’t intended to be strictly compatible with standard HTML. The basic idea is that a section of text can be enclosed inside a pair of matching tags:-

标记 markup 系统由 HTML 启发，但也不打算成为严格地符合标准的 HTML。其基本思 想是可以里面一对匹配的标记 tags 括起来的一段文本：-

We are not amused

As the example shows, the tags are just pieces of text inside the “angle bracket” characters, < and >. The text inside the tag denotes its name (which in this case is just b). Note that the tag at the end of the section has the same name as the one at the start but with the slash / character added. The tags are not displayed to the user directly but are interpreted as instructions for styling the text they enclose. The b tag used in the example above applies boldface to the word “not”, so the text will appear onscreen as:-

如示例所示，标签 tags 只是一张的"尖括号"字符， < 和 >。在 text 内的标签表示其名 称 （即在这种情况下只是 b）。注意 结束标记具有和开始相同的名称，但 添加斜杠 / 字符。 标签不直接显示给用户，但将被解释为关于 styling 的文本说明。在上面的示例中使用的 b 标记的黑体字单词"not"，因此文本将出现在屏幕上为：-

We are not amused

A marked up section of text (including the tags that enclose it) is referred to as an element.

一个标记 marked 的文本字段 （包括括起来的标记 tags） 节称为元素。

Nested elements

It is possible to apply more than one style to a section of text by “nesting” one element inside another

对于一段文本它可能应用不止一种样式，通过“nesting”

We are definitely not amused

The i tag applies italic style, so this would be presented onscreen as

这个 i 标记 tag 是斜体样式，因此这将会在屏幕上显示：

We are definitely not amused

Note the ordering of the ending tags, which is in reverse to that of the starting tags. The reason for this is perhaps clearer when you consider that the inner tags need not span the whole text of the outermost element

请注意结束标记的排序，这 和起始标签是反向的。因为内部标记不需要跨越到外部的整个文本。

We are absolutely definitely not amused

which gives

显示为：

We are absolutely definitely not amused

Tag parameters

Some tags have a simple all-or-nothing effect on the text but others might allow for variations. For example, the color tag needs to know which color to apply. Information like this is added to tags by the use of parameters:-

We are green with envy

Note that the ending tag doesn’t include the parameter value. Optionally, the value can be surrounded by quotation marks but this isn’t required.

Supported tags

The following list describes all the styling tags supported by Unity.

下面的列表描述了统一所支持的所有 styling tags。

Color name	Hex value	Swatch
aqua (same as cyan)	#00ffffff
black	#000000ff
blue	#0000ffff
brown	#a52a2aff
cyan (same as aqua)	#00ffffff
darkblue	#0000a0ff
fuchsia (same as magenta)	#ff00ffff
green	#008000ff
grey	#808080ff
lightblue	#add8e6ff
lime	#00ff00ff
magenta (same as fuchsia)	#ff00ffff
maroon	#800000ff
navy	#000080ff
olive	#808000ff
orange	#ffa500ff
purple	#800080ff
red	#ff0000ff
silver	#c0c0c0ff
teal	#008080ff
white	#ffffffff
yellow	#ffff00ff

material

This is only useful for text meshes and renders a section of text with a material specified by the parameter. The value is an index into the text mesh’s array of materials as shown by the inspector.

这只是使用 text meshes 呈现一段文本，这个材料通过所指定的参数设定。值是索引在 text meshes 数组中的材料，检查器 inspector 中的。

We are texturally amused

quad

This is only useful for text meshes and renders an image inline with the text. It takes parameters that specify the material to use for the image, the image height in pixels, and a further four that denote a rectangular area of the image to display. Unlike the other tags, quad does not surround a piece of text and so there is no ending tag - the slash character is placed at the end of the initial tag to indicate that it is “self-closing”.

这只是使用文本网格并呈现图像与内联文本。它采用参数，指定 material，使用的图像， 图像的高度 （以像素为单位） 和表示要显示的图像的一个矩形区域。不同于其他标签 tags， quad 不会围绕着一段文字，所以没有结束标记-斜杠字符放在结尾，以指示它是"自闭"。

<quad material=1 size=20 x=0.1 y=0.1 width=0.5 height=0.5 />

This selects the material at position in the renderer’s material array and sets the height of the image to 20 pixels. The rectangular area of image starts at given by the x, y, width and height values, which are all given as a fraction of the unscaled width and height of the texture.

这选择材料在 renderer’s material 数组中的位置，并将图像的高度设置为 20 像素。矩形区 域的图像开始得到的 x、 y、 宽度和高度值，都被赋予了作为未缩放宽度的一小部分和纹 理的高度。

Editor GUI

Rich text is disabled by default in the editor GUI system but it can be enabled explicitly using a custom GUIStyle. The richText property should be set to true and the style passed to the GUI function in question:-

Rich text 默认是不显示在 editor GUI system，但可以启用显式使用自定义的 GUIStyle。 richText 属性应设置为 true 和传递到 GUI 函数的风格：-

GUIStyle style = new GUIStyle ();
style.richText = true;
GUILayout.Label("<size=30>Some <color=yellow>RICH</color> text</size>",style);