开发 组件 基础组件 rich-text
# rich-text
更新时间:2024-09-18 14:46:35
富文本。
# 属性
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
nodes | string | PropNode<'a' | 'abbr' | 'address' | 'article' | 'aside' | 'b' | 'bdi' | 'bdo' | 'big' | 'blockquote' | 'br' | 'caption' | 'center' | 'cite' | 'code' | 'col' | 'colgroup' | 'dd' | 'del' | 'div' | 'dl' | 'dt' | 'em' | 'fieldset' | 'font' | 'footer' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'header' | 'hr' | 'i' | 'img' | 'ins' | 'label' | 'legend' | 'li' | 'mark' | 'nav' | 'ol' | 'p' | 'pre' | 'q' | 'rt' | 'ruby' | 's' | 'section' | 'small' | 'span' | 'strong' | 'sub' | 'sup' | 'table' | 'tbody' | 'td' | 'tfoot' | 'th' | 'thead' | 'tr' | 'tt' | 'u' | 'ul'>[] | [] | 否 | 节点列表/HTML String |
space | 'ensp' | 'emsp' | 'nbsp' | 否 | 显示连续空格 |
# space
显示连续空格
值 | 说明 |
---|---|
'ensp' | 中文字符空格一半大小 |
'emsp' | 中文字符空格大小 |
'nbsp' | 根据字体设置的空格大小 |
# nodes
现支持两种节点,通过 type 来区分,分别是元素节点和文本节点,默认是元素节点,在富文本区域里显示的 HTML 节点
# 元素节点:type = node
属性 | 说明 | 类型 | 必填 | 备注 |
---|---|---|---|---|
name | 标签名 | string | 是 | 支持部分受信任的 HTML 节点 |
attrs | 属性 | object | 否 | 支持部分受信任的属性,遵循 Pascal 命名法 |
children | 子节点列表 | array | 否 | 结构和 nodes 一致 |
# 文本节点:type = text
属性 | 说明 | 类型 | 必填 | 备注 |
---|---|---|---|---|
text | 文本 | string | 是 | 支持 entities |
# 受信任的 HTML 节点及属性
全局支持 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 | |
nav | |
ol | start,type |
p | |
pre | |
q | |
emsp | |
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 |
- tip: nodes 不推荐使用 String 类型,性能会有所下降。
- tip:
rich-text
组件内屏蔽所有节点的事件。 - tip: attrs 属性不支持 id ,支持 class 。
- tip: name 属性大小写不敏感。
- tip: 如果使用了不受信任的 HTML 节点,该节点及其所有子节点将会被移除。
- tip: img 标签仅支持网络图片。
- tip: 如果在自定义组件中使用
rich-text
组件,那么仅自定义组件的 css 样式对rich-text
中的 class 生效。
# 扫码体验
# 示例代码
上一篇:《progress》
下一篇:《text》
仍有疑问? 前往社区提问