rich-text

富文本。

属性类型默认值说明最低版本
nodesArray / String[]节点列表 / HTML String
spaceString显示连续空格

space 有效值：

值说明
ensp中文字符空格一半大小
emsp中文字符空格大小
nbsp根据字体设置的空格大小

支持默认事件，包括：tap、touchstart、touchmove、touchcancel、touchend和longtap

nodes 属性推荐使用 Array 类型，由于组件会将 String 类型转换为 Array 类型，因而性能会有所下降

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
b
blockquote
br
code
colspan，width
colgroupspan，width
dd
del
div
dl
dt
em
fieldset
h1
h2
h3
h4
h5
h6
hr
i
imgalt，src，height，width
ins
label
legend
li
olstart，type
p
q
span
strong
sub
sup
tablewidth
tbody
tdcolspan，height，rowspan，width
tfoot
thcolspan，height，rowspan，width
thead
tr
ul

示例：

  1. <!-- rich-text.qml -->
  2. <rich-text nodes="{{nodes}}" bindtap="tap"></rich-text>
// rich-text.js
Page({
  data: {
    nodes: [{
      name: 'div',
      attrs: {
        class: 'div_class',
        style: 'line-height: 60px; color: red;'
      },
      children: [{
        type: 'text',
        text: 'Hello&nbsp;World!'
      }]
    }]
  },
  tap() {
    console.log('tap')
  }
})
Bug & Tip
  • tip: nodes 不推荐使用 String 类型，性能会有所下降。
  • tip: rich-text 组件内屏蔽所有节点的事件。
  • tip: attrs 属性不支持 id ，支持 class 。
  • tip: name 属性大小写不敏感。
  • tip: 如果使用了不受信任的HTML节点，该节点及其所有子节点将会被移除。
  • tip: img 标签仅支持网络图片。
  • tip: 如果在自定义组件中使用 rich-text 组件，那么仅自定义组件的 qss 样式对 rich-text 中的 class 生效。