rich-text

富文本。

属性说明

属性名类型默认值说明
nodesArray / String[]节点列表 / HTML String

注意

  • app-nvue 平台 nodes 属性只支持使用 Array 类型

  • 支付宝小程序 nodes 属性只支持使用 Array 类型。

如果需要支持 HTML String，则需要自己将 HTML String转化为 nodes 数组，可使用 html-parser 转换。

支持默认事件，包括：click、touchstart、touchmove、touchcancel、touchend、longpress。

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. <template>
  2.     <view class="content">
  3.         <page-head :title="title"></page-head>
  4.         <view class="uni-padding-wrap">
  5.             <view class="uni-title uni-common-mt">
  6.                 数组类型
  7.                 <text>\nnodes属性为Array</text>
  8.             </view>
  9.             <view class="uni-common-mt" style="background:#FFF; padding:20rpx;">
  10.                 <rich-text :nodes="nodes"></rich-text>
  11.             </view>
  12.             <view class="uni-title uni-common-mt">
  13.                 字符串类型
  14.                 <text>\nnodes属性为String</text>
  15.             </view>
  16.             <view class="uni-common-mt" style="background:#FFF; padding:20rpx;">
  17.                 <rich-text :nodes="strings"></rich-text>
  18.             </view>
  19.         </view>
  20.     </view>
  21. </template>
  1. export default {
  2.     data() {
  3.         return {
  4.             nodes: [{
  5.                 name: 'div',
  6.                 attrs: {
  7.                     class: 'div-class',
  8.                     style: 'line-height: 60px; color: red; text-align:center;'
  9.                 },
  10.                 children: [{
  11.                     type: 'text',
  12.                     text: 'Hello&nbsp;uni-app!'
  13.                 }]
  14.             }],
  15.             strings: '<div style="text-align:center;"><img src="https://img-cdn-qiniu.dcloud.net.cn/uniapp/images/uni@2x.png"/></div>'
  16.         }
  17.     }
  18. }

uniapp

Tips

  • nodes 不推荐使用 String 类型，性能会有所下降。
  • rich-text 组件内屏蔽所有节点的事件。所以如果内容中有链接、图片需要点击，则不能使用rich-text，此时可在uni-app插件市场搜索uparse插件使用。
  • attrs 属性不支持 id ，支持 class 。
  • name 属性大小写不敏感。
  • 如果使用了不受信任的HTML节点，该节点及其所有子节点将会被移除。
  • img 标签仅支持网络图片。
  • 如果在自定义组件中使用 rich-text 组件，那么仅自定义组件的 css 样式对 rich-text 中的 class 生效。

发现错误？想参与编辑？在 GitHub 上编辑此页面！