Rich Text允许你用一些tags标记来更改文本的外观和布局。这些tags的工作方式类似于HTML或XML标记,但语法没那么严格。
tag 长的大概是这样 <tag>。许多标记在一个作用域上运行,可以 </tag>结束。这样的作用域可以嵌套,而不必按照启动它们的顺序去关闭它们。
有些tag具有值和属性,例如 <tag=value>和 <tag attribute=value>。这些参数要么是名称,要么是数值。数字要么是普通的十进制数字,像1px这样的像素,80%这样的百分比,1.2em这样的字体单位,或者是十六进制的颜色值,比如#FF。名称可以有双引号,也可以没有双引号,但是如果有很多属性的话,最好使用引号。
tag加上它们的attributes可以长达128个字符。除非您使用非常长的字符串属性,否则该限制不应成为问题。
1、Tag Overview
![f34edf6d36a712098b5f9d1000888031.png](https://i-blog.csdnimg.cn/blog_migrate/c7fdd4b600e510d655fd68a17224221a.jpeg)
2、Text Alignment
每个text object都有一个完全对齐方式,但是tag 去覆盖它,所有四个水平对齐选项都可用。
通常会将这些tag放在段落的开头。如果同一条文本时存在多个对齐方式,那么最后一个起效。
连续对齐范围不会叠加。 </align>tag会结束所有的对齐类型的格式。看下效果
<align="right">Right
<align="center">Center
<align="left">Left
![4b65c965f248f2419d31d907873dadf7.png](https://i-blog.csdnimg.cn/blog_migrate/d89da787f11a185e65a835915e606b6e.png)
3、Color
你可以通过各种方式更改文本的颜色。最直接的方法是使用 <color=“color Name”>。支持的颜色名称是black, blue, green, orange, purple, red, white, and yellow。
也可以使用十六进制数字来指定颜色。这些颜色是窗体#FFFFFFF或#ffffff(如果您还想定义alpha值)。在这种情况下,可以省略颜色tag名。
<color="red">Red <color=#005500>Dark Green <#0000FF>Blue <color=#FF000088>Semitransparent Red
![5052347ffd055bc399ffcd2bbab168f5.png](https://i-blog.csdnimg.cn/blog_migrate/8e6512de8f3f9df1662e4c9b9a2de170.png)
如果只想更改text的不透明度,可以使用alpha标记。它适用于十六进制值。
<alpha=#FF>FF <alpha=#CC>CC <alpha=#AA>AA <alpha=#88>88 <alpha=#66>66 <alpha=#44>44 <alpha=#22>22 <alpha=#00>00
![dcf0edb09759bd3bc8013bb8705aee5a.png](https://i-blog.csdnimg.cn/blog_migrate/cab907a6ee0706b63d7d2eae5913429b.png)
要注意的是,所有颜色调整都用相同的颜色tag终止,不管之前使用的是哪个开始的标记。
<color="red">Red, <color="blue">Blue, </color> and red again.
![199e101819e33c1d360fdce960724b2d.png](https://i-blog.csdnimg.cn/blog_migrate/42df64a972e732eadf4dc6ebe2ec8dc5.png)
4、Bold and Italic
你可以简单的标签来表示文本的粗体和斜体样式。这些样式的外观由由正在使用的font asset定义的。
The <i>quick brown fox </i> jumps over the <b>lazy dog </b>.
![ec616da7c4ba6a11801ab0e3e2333c60.png](https://i-blog.csdnimg.cn/blog_migrate/652558f6497540e2a9237752c0bd5787.png)
5、Character Spacing
cspace 允许您调整字符间距,无论是固定的还是相对于原始字体的。也可以使用像素或字体单位。正的数值把字符分开,而负的数值的把它们拉在一起。 </cspace>结束标记之后会返回到字体的正常间距。
<cspace=1em>Spacing </cspace> is just as important as <cspace=-0.5em>timing.
![cd9e076b05ed02687999ff012ebb7b9a.png](https://i-blog.csdnimg.cn/blog_migrate/f02d8162127c794926b20fd537077e9f.png)
6、Font
通过 <type=“fontAssetName”>可以切换到另一种字体。知道遇到关闭标签之前,都会保持新字体的引用。你也可以指定要使用的materials ,这样就可以在不同的materials 之间切换单个字体的表现。fonts和materials asset 必须放在asset setting中定义的特定文件夹内。
font tag 可以嵌套使用。若要恢复到默认字体,可以通过关闭所有字体tag或使用default font asset 名称来完成。
Would you like <font="Impact SDF">a different font? </font> or just <font="NotoSans" material="NotoSans Outline">a different material?
![67e559668c6dc7bef8f3b614d66f495b.png](https://i-blog.csdnimg.cn/blog_migrate/b537787a919480f2f0ac4bc561de2b32.png)
7、Indentation
indent tag 与pos tag 的作用相同,但这种效果跨行仍然存在。您可以使用它来创建布局,就像是一个文字包装。可以使用像素、字体单位或百分比来描述缩进。
- <indent=15%>It is useful for things like bullet points. </indent>
- <indent=15%>It is handy.
8、Line Height
line-height tag 让你可以手动控制行的高度.用它把行拉得更近,或者把它们推得更远。由于行高控制下一行开始的距离,所以此tag不会更改当前行。
可以使用像素、字体单位和百分比来作为参数。相对调整基于font asset 指定的行高.结束标记将会恢复到此高度。
Line height at 100%
<line-height=50%>Line height at 50%
<line-height=100%>Rather cozy.
<line-height=150%>Line height at 150%
Such distance!
![15af3746e319f9dbaed6e8c9f3f42f58.png](https://i-blog.csdnimg.cn/blog_migrate/7941827397c0f310dfea2ed21ad30105.png)
9、Line Indentation
line-indent是在每一行开始钱直接插入一些水平空间。它只影响手动换行,不影响文字结尾自动行。您可以使用像素、字体单位或百分比。结束标签会结束这个效果
<line-indent=15%>This is the first line of this text example.
This is the second line of the same text.
![c06ce5975db3157f97f097ec3a9a24bf.png](https://i-blog.csdnimg.cn/blog_migrate/b8fed2f471123c06b4db45976814d8a9.png)
10、Text Link
可以使用 <link=“ID”>my link </link>向文本段添加链接元数据。链接ID需要是唯一的,以便在用户与文本交互时检索其ID和链接文本内容。
但并不是说每个链接一定要一个唯一的ID。如果有需要,您可以重用ID,例如,当您多次链接到同一个数据的时候,LinkInfo数组只包含每个ID一次。
虽然此Link tag 允许用户交互,但它不会更改链接文本的外观。还需要使用其他标签配合。
11、Lowercase, Uppercase, and Smallcaps
这三个tags 用于更改文本的大写,小写和大写标记。工作方式与您预期的一样。smallcaps 是uppercase的另一种方式。
smallcaps tag 的工作方式类似于uppercase,但它减少了所有原本不是大写字母的字符的大小。
<lowercase>Alice and Bob watched TV. </lowercase>
<uppercase>Alice and Bob watched TV. </uppercase>
<smallcaps>Alice and Bob watched TV. </smallcaps>
![417d994c07c6688e1db65074408ba7b3.png](https://i-blog.csdnimg.cn/blog_migrate/8ed6cb0d40f5794ccac3c93c8d4c1d93.png)
12、Margin
可以使用页边距tag调整文本的水平边距。如果您只想调整左或右边距,您可以使用margin-left或margin-right tag。和上面的其他标签一样,可以使用像素、字体单位和百分比来表达。
Our margins used to be very wide.
<margin=5em>But those days are long gone
![962f85ba234db37a07e90a75d1e37048.png](https://i-blog.csdnimg.cn/blog_migrate/44d22186c6dfef5282e25534a8f00373.png)
13、Mark
mark在文本的顶部添加一个特别的覆盖(译注:类似于荧光笔?)。您可以使用它突出显示文本的部分。因为标记位于文本的上层,所以你必须给它们一个半透明的颜色才能看到文本。
mark tag 不会堆叠,它们会互相取代。
Text <mark=#ffff00aa>can be marked with </mark> an overlay.
![129fc0c58fd58d72407fc2f8adb3f9da.png](https://i-blog.csdnimg.cn/blog_migrate/fdc89f55b08156eae9ea273f910b8ac4.png)
14、Monospacing
可以重新调整字体的字符间距,并使用mspace标记将其转换为单空间字体。这会让所有字符都有相同的水平空间。用像素或字体单位来设置单空格字符宽度。
Any font can become <mspace=2.75em> monospace, if you really want it.
![ef18682b966a34e14f46aef1fc54df78.png](https://i-blog.csdnimg.cn/blog_migrate/7c5c3c797e30c6645a88382ce12b9503.png)
15、Noparse
有的时候,你希望文本不要被rich text解析,比如就想显示 <b>,那么就可以禁用rich tags来处理这样的问题。但是,如果又希望在同一文本中使用tag ,则可以使用noparse标记来指定不解析的范围。
Use <noparse> <b> </noparse> for <b>bold </b> text.
![02f230e4ffda43d44949f4b292266011.png](https://i-blog.csdnimg.cn/blog_migrate/ce65f4abec27dc86ffec87c5eabf3807.png)
16、Non-breaking Spaces
如果你想让单词保持在一起而不被word wrapping所分隔,你可以使用nobr 标签。
You don't want <nobr>I M P O R T A N T </nobr> things to be broken up.
![e14568c4589784a18fe0634b39ee8c48.png](https://i-blog.csdnimg.cn/blog_migrate/663e083c8e2e9c06fcbc29e1571e49da.png)
17、Page Break
您可以使用page标签在文本中插入分页符。这将文本分割成不同的块。文本对象必须设置为page overflow模式才能显示正常。
18、Horizontal Position
pos标记使您可以直接控制水平插入符的位置。您可以将它放在同一行的任何位置,而不用管它是从哪里开始的。同样可以使用像素、字体单位或百分比。此标记最好与左对齐一起使用。
at <pos=75%>75%
at <pos=25%>25%
at <pos=50%>50%
at 0%
![dbc55994d3bddfed501fdcedf76dcdc4.png](https://i-blog.csdnimg.cn/blog_migrate/f7a5c44055545e3fd3de3d26112fd94c.png)
19、Font Size
可以使用tag随时调整文本的字体大小。单位可以像素、字体单位或百分比。像素调整可以是绝对的,也可以是相对的,比如+1和-1.但所有相对大小都是基于原始字体大小而言的,因此它们不是叠加的。
<size=100%>Echo <size=80%>Echo <size=60%>Echo <size=40%>Echo <size=20%>Echo
![8a76ffb3b1714b7d12731db88dd39e5e.png](https://i-blog.csdnimg.cn/blog_migrate/77f7c81b44af70cc939b5745a2da413a.png)
20、Horizontal Space
space 标记用来插入水平偏移量,就像插入多个空格一样。可以使用像素或字体单位。
Give me some <space=5em> space.
![15219b0f1fdc142287ab60a336cf600e.png](https://i-blog.csdnimg.cn/blog_migrate/65bd15f59cb1859d1dcd2620a611bc65.png)
21、Sprite
您可以使用sprite标记将 sprite atlas中的图像插入到文本中。您可以通过index <sprite index=1或name <sprite name=“spriteName”>来访问spriteName。它会从default asset中插入一个sprite。
要使用不同的sprite asset的话,请使用 <sprite=“assetName”index=1>或 <sprite=“assetName”name=“spriteName”>。Sprite assets必须位于由settings asset定义的特定文件夹中。
如果使用default sprite asset中的sprite 索引,则可以使用索引速记 <sprite=1>。
默认情况下,sprites不受文本的Color (Vertex)设置的影响。但如果将tint=1属性添加到标记中将会让sprites也具有此颜色。还可以通过添加color=#FFFFFFF来使用特定的颜色。
Sprites! <sprite=0> More sprites! <sprite index=3> And even more! <sprite name="Default Sprite Asset_4" color=#55FF55FF>
![b3982a746a7183c17779e8f41569496d.png](https://i-blog.csdnimg.cn/blog_migrate/783e5d34ea751e703ecbda89edd01ea7.png)
22、Strikethrough and Underline
您可以添加删除线和下划线,下划线略低于baseline。垂直偏移量由font asset定义。划过的地方稍微高于baseline。
The <s>quick brown </s> fox jumps over <u>the lazy dog </u>.
![c8e2ef0884f48c06e5fdc25a4b6448a3.png](https://i-blog.csdnimg.cn/blog_migrate/a756cee8497dc2068f5e9489bf455e85.png)
23、Style
可以通过style 标记访问自定义样式。你需要为开始标记指定style名称,结束标记不需要。比如下面的例子,只是关闭了最后一个打开的style。
<style="Title">Styles </style>
You can create your own.
![a4373c0dcf504dd21f9f25998e2c8dc8.png](https://i-blog.csdnimg.cn/blog_migrate/cbefe4109eaaf17d359eb5ebe44cc638.png)
24、Subscript and Superscript
sup和sub tag允许您将文本布局为上标或下标。它们的偏移量和大小由font asset定义。这常常用于科学符号和编号,如1st和2nd。
We have 1m <sup>3 </sup> of H <sub>2 </sub>O
![bdef80acc842c595c07cc9cdac757635.png](https://i-blog.csdnimg.cn/blog_migrate/d0b07fb6590adbb18a87ad2b12de171b.png)
25、Vertical Offset
voffset偏移量给baseline 一个垂直偏移量。您可以使用像素或字体单位,但它总是相对于原始baseline的。结束标记将重置回原始baseline。
它会自动调整行高以适应移位的文本。但如果你不想让它便宜,你可以手动调整行的高度。
Up <voffset=1em>up <voffset=2em>UP </voffset> and <voffset=-0.5em>down </voffset> we go again.
![0170e2c5f25bf2250881c9bcee86dac3.png](https://i-blog.csdnimg.cn/blog_migrate/6172a9c5ec084ca523f49e706811d117.png)
26、Text Width
像素、字体单位或百分比用于 width 标记 调整文本区域的水平大小。但是不管如何,它不会超出文本对象的原始大小。
更改在当前行上生效,并且只在标记本身之后生效。你通常把它放在段落的开头。
宽度调整相互覆盖,结束tag将会恢复到原来的width 。
I remember when we had lots of space for text.
<width=60%>But those days are long gone.
![dd03b1f8d39e420311895b42164c3384.png](https://i-blog.csdnimg.cn/blog_migrate/a23d40e07c0f412cf7ff6cad7e2ef33c.png)