Skip to content

UIText 富文本

富文本(RichText)用来显示一段带有不同样式效果的文字,你可以通过一些简单的XML标签来设置文字的样式。并且不同的XML标签是可以支持相互嵌套的。

功能开关

此功能默认关闭,开启后则文本内容可以支持富文本。

或者使用richText开启对富文本的支持。

富文本的支持

以下是目前支持的富文本标签:

font 字体

属性类型说明
sizestring字体大小
colorstring十六进制颜色值,参考:颜色取色

stroke 描边

属性类型说明
thicknessstring描边宽度
opacitystring(0-1)描边透明度
colorstring十六进制颜色值,参考:颜色取色

使用示例

xml
你好,我是<font size="25" color="#F55505">吉吉喵</font>。我是神岛可爱的<stroke thickness="10" opacity="0.6">吉祥物</stroke>。

你好,我是<font size="25" color="#F55505"><font size="48" color="#5520D0">文档</font>喵</font>。我也是<font size="12" color="#2CDC67">神岛</font>可爱的<stroke thickness="10" opacity="0.6">吉祥物</stroke>。

关于富文本的说明

生效规则

  • 富文本标签只影响被标记部分文本的样式,未被标记的文本则继承元素文本的初始配置。
  • 在编辑模式下,文本输入过程不会解析富文本,但是会在确认文本输入后,尝试进行解析展示,属性面板内的文本内容始终为原始内容。
  • 如用户富文本内容含有语法错误无法解析,则内容将被视为普通文本内容进行展示。

富文本嵌套

  • 支持富文本嵌套使用。
  • 当富文本中嵌套多个标签时,样式优先级依赖于嵌套顺序;内层的标签优先级更高,如:某个文本被两个不同的标签设置了颜色,最终显示的是内层标签的颜色。