# rich-text

组件类型:UniRichTextElement

富文本。可渲染文字样式、图片、超链接。支持部分HTML标签

# 兼容性

Web 微信小程序 Android iOS
4.0 4.41 3.9 4.11

# 支持的HTML标签和属性

HTML 属性 样式
br
p text-align color background-color text-decoration
ul
li text-align color background-color text-decoration
span color background-color text-decoration
strong
i
big
small
a href
u
del
h1-h6
img src

text-decoration仅支持line-through

# 属性

名称 类型 默认值 兼容性 描述
nodes array | string -
节点列表 | HTML String
selectable boolean false
文本是否可选
@itemclick (event: UniRichTextItemClickEvent) => void -
拦截点击事件(只支持 a、img标签),返回img标签的src属性或a标签的href属性。event.detail={ src | href }
space string -
(string)
显示连续空格
合法值 兼容性 描述
ensp
emsp
nbsp
user-select boolean -
-

# 事件

# UniRichTextItemClickEvent

# UniRichTextItemClickEvent 的属性值
名称 类型 必填 默认值 兼容性 描述
detail UniRichTextItemClickEventDetail - -
名称 类型 必备 默认值 兼容性 描述
src string - - <img/>图片链接
href string - - <a/>超链接

# 子组件

不可以嵌套组件

# 示例

hello uni-app x

扫码体验(手机浏览器跳转到App直达页)

Template

Script

<template>
  <view>
    <page-head title="rich-text"></page-head>
    <view class="uni-padding-wrap uni-common-mt">
      <view class="uni-btn-v">
        <navigator url="/pages/component/rich-text/rich-text-tags">
          <button type="primary">rich-text渲染单个HTML标签示例</button>
        </navigator>
      </view>
      <view class="uni-btn-v">
        <navigator url="/pages/component/rich-text/rich-text-complex">
          <button type="primary">rich-text渲染复杂HTML示例</button>
        </navigator>
      </view>
      <view class="uni-title">
        <button type="default" @click="changeText">修改文本内容</button>
      </view>
      <view class="text-box" id="rich-text-parent" @click="richTextParentClick">
        <rich-text id="richtext" style="border: 1px; border-style: solid; border-color: red;" :selectable="true"
          :nodes="text"></rich-text>
        <view>
          <text>rich-text-parent</text>
          <text id='rich-text-str'>{{richTextStr}}</text>
        </view>
      </view>
      <view class="uni-title">
        <text class="uni-subtitle-text">selectable</text>
      </view>
      <view class="text-box2">
        <rich-text style="height: 80px;" :selectable="true"
          :nodes="text"></rich-text>
      </view>
    </view>
  </view>
  <rich-text v-if="autoTest" id="test-rich-text" :nodes="testNodes" :selectable="true" @itemclick="itemClickForTest" style="position: fixed;width: 100px;height: 100px;"></rich-text>
</template>



<style>
  .text-box {
    padding: 20px 0;
    background-color: white;
  }

  .text-box2 {
    top: 20px;
    background-color: white;
  }

</style>

# 参见

# Bug & Tips

  • HTML String在App端支持常用但不是全部web样式,并且Android和iOS也略有差异。
  • HTML String类型的<img/>不支持自定义宽高,默认以rich-text组件宽度为基准等比缩放;节点列表类型的<img />支持自定义宽高。
  • App-Android平台,设置selectable属性为 true 时,itemclick事件不触发。