# rich-text

基础库 1.4.0 开始支持，低版本需做兼容处理。

微信 Windows 版：支持

微信 Mac 版：支持

微信鸿蒙 OS 版：支持

渲染框架支持情况：Skyline （使用最新 Nighly 工具调试）、WebView

# 功能描述

富文本。

自基础库 2.33.0 版本开始支持（3.0.0 除外）。
遵循 skyline 的样式和布局规则，html tag 被映射成类似 text/span/view 节点，因此存在 text 嵌套问题。
不支持 td/tr 等表格布局 tag，也不支持 bdo/bdi 等文字排版 tag。建议完全使用 flex 等 skyline 支持的布局方式来创建富文本内容。
提供了可选的兼容布局模式选项 mode，但仍不保证与 WebView 表现 100% 一致。
在 2.33.0 基础库下，请尽可能避免为 html tag 使用 wx-rich-text 开头的类名。

属性

类型

默认值

必填

说明

最低版本

nodes

array/string

[]

否

节点列表/HTML String

space

string

否

显示连续空格

user-select

boolean

false

否

文本是否可选，该属性会使节点显示为 block

属性类型默认值必填说明

mode string default 否布局兼容模式

合法值	说明
default	完全遵循 skyline 的默认行为，不对节点树进行任何更改。
compat	尽可能将 tag 映射为 `<view><span></span></view>` 的形式。通常最接近 webview 的表现。
aggressive	所有 tag 均被映射为形如 `<view><span></span></view>` 的形式。
inline-block	实验性的 inline-block 布局策略，但无法实现折行。
web	使用 webview 渲染富文本，基础库 3.6.0 开始支持。

现支持两种节点，通过type来区分，分别是元素节点和文本节点，默认是元素节点，在富文本区域里显示的HTML节点

属性	说明	类型	必填	备注
text	文本	string	是	支持entities

全局支持class和style属性，不支持id属性。

节点	属性
a
abbr
address
article
aside
b
bdi
bdo	dir
big
blockquote
br
caption
center
cite
code
col	span，width
colgroup	span，width
dd
del
div
dl
dt
em
fieldset
font
footer
h1
h2
h3
h4
h5
h6
header
hr
i
img	alt，src，height，width
ins
label
legend
li
mark
nav
ol	start，type
p
pre
q
rt
ruby
s
section
small
span
strong
sub
sup
table	width
tbody
td	colspan，height，rowspan，width
tfoot
th	colspan，height，rowspan，width
thead
tr	colspan，height，rowspan，width
tt
u
ul