富文本

富文本

阅读本文大概需要 5 分钟

本文概述了文本控件/文本框控件中富文本功能的使用方法。

什么是富文本？

富文本 ，又称多文本格式，使用特定的富文本标记格式，可使一个文本控件/文本框控件内的文本实现不同字号、不同颜色等多种效果；与富文本相对应的是纯文本，即完全根据UI控件的文本设置来格式化的文本

如何使用富文本？

首先，在需要使用富文本的文本/输入框控件的属性面板中找到【文本】-【富文本】属性，并勾选

再按照下面的标记格式表，在文本/输入框控件中输入带有开始和结束标签的格式化文本内容，脱离输入状态后，文本内容就会按照标签显示为富文本样式，示例：

ts

//<u>格式化的文本</u>

//<u>格式化的文本</u>

文本可以相互嵌套，只要结束标签的顺序与开始标签相反即可，示例：

ts

//<u><s>格式化的文本</s></u> 或者 <s><u>格式化的</u>文本</s>都可以识别；
//而<s><u>格式化的文本</s></u> 或者 <u>格<s>式化的</u>文本</s>不能被正确识别

//<u><s>格式化的文本</s></u> 或者 <s><u>格式化的</u>文本</s>都可以识别；
//而<s><u>格式化的文本</s></u> 或者 <u>格<s>式化的</u>文本</s>不能被正确识别

自适应文本框功能的计算暂不考虑富文本的字号大小，因此请勿同时使用富文本与自适应文本框

富文本标记格式列表

富文本标记格式列表
- 目前编辑器的默认中文字体暂不支持粗体、斜体、粗斜体字形，后续会补充

标签	描述	示例
`<b>`	以粗体显示文本	We are `<b>not</b>` amused.
`<i>`	以斜体显示文本	We are `<i>usually</i>` amused.
`<size=50>`	根据参数值设置文本的大小	We are `<size=50>`largely`</size>` unaffected.
`<color=#ff0000ff>或<color=#red>`	根据参数值#rrggbbaa设置文本的颜色，分别表示颜色的红、绿、蓝和 Alpha（透明度）值，大小写都能识别20种常用颜色可以直接使用颜色名称，大小写都能识别	We are `<color=#ff0000ff>colorfully</color>` amused We are `<color=#red>colorfully</color`> amused
`<u>`	以下划线显示文本	We are `<u>not</u>` amused.
`<s>`	以删除线显示文本	We are `<s>not</s>` amused.
`<!-- -->`	备注，即不显示里面的文本	WWe are not amused.`<!--not shown-->`

20种常用颜色和颜色名对应表

颜色名称	十六进制值	样本
black	`#000000ff`
blue	`#0000ffff`
brown	`#a52a2aff`
cyan	`#00ffffff`
darkblue	`#0000a0ff`
fuchsia	`#ff00ffff`
green	`#008000ff`
grey	`#808080ff`
lightblue	`#add8e6ff`
lime	`#00ff00ff`
maroon	`#800000ff`
navy	`#000080ff`
olive	`#808000ff`
orange	`#ffa500ff`
purple	`#800080ff`
red	`#ff0000ff`
silver	`#c0c0c0ff`
teal	`#008080ff`
white	`#ffffffff`
yellow	`#ffff00ff`

富图片及其标记格式列表

文本框/输入框控件支持使用标记格式插入富图片，富图片功能目前支持使用233娘表情图共94张
使用方法：将文本框/输入框控件的富文本属性开启，在文字输入富图片的对应标记格式，标记格式会自动转成富图片，富图片的尺寸由文本框的字号大小决定
如果使用了ChatBubble类的聊天气泡接口，能自动支持将房间内聊天使用到的233表情同步显示在聊天气泡中
请注意：目前这批233娘的富图片仅支持在国内环境使用，请谨慎使用，处理海外本地化时应将所使用的富图片去除，否则会展示标记格式原文本
富图片标记格式对应表

富图片标记格式	图片
[发怒]
[鼓掌]
[背叛]
[大笑]
[笑容满面]
[黑线]
[羞]
[快哭了]
[冷汗]
[冲]
[酷]
[抓狂]
[新月脸]
[哭哭]
[可爱]
[鄙视你]
[在做了]
[疑问]
[吃饭]
[期待]
[打call]
[财迷]
[委屈]
[皱眉]
[满月脸]
[收到]
[拜拜]
[做鬼脸]
[呲牙]
[我晕]
[愉快]
[心心脸]
[送心心]
[吐血]
[稍等]
[摊手]
[求抱抱]
[灵光一闪]
[无辜笑]
[烦躁]
[小丑]
[敲键盘]
[飞吻]
[亲亲]
[笑]
[笑哭]
[嬉笑]
[柠檬]
[听音乐]
[心]
[戴口罩]
[调皮]
[抠鼻]
[我看行]
[惊恐]
[派对]
[我想静静]
[石化]
[可怜]
[撇嘴]
[尬笑]
[举手]
[翻白眼]
[致敬]
[流泪]
[注意]
[震惊]
[闭嘴]
[害羞]
[叹气]
[骷髅]
[酣睡]
[困]
[开心]
[打脸]
[骄傲]
[泣不成声]
[无奈]
[敲打]
[强]
[奋斗]
[惊呆]
[汗]
[泪奔]
[感谢]
[思索]
[偷笑]
[摸头]
[呕吐]
[vr]
[坏笑]
[机智]
[哈欠]
[耶]