# rich-text

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

# 支持的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: RichTextItemClickEvent) => void - 拦截点击事件(只支持 a、img标签),返回用户自定义数据或img标签的src属性或a标签的href属性。event.detail={ ref | src | href }

# # 事件

# # RichTextItemClickEvent

# # RichTextItemClickEvent 属性值
名称 类型 必填 默认值 描述
detail RichTextItemClickEventDetail - -
type string - 事件类型
target Element - 触发事件的组件
currentTarget Element - 当前组件
timeStamp number - 事件发生时的时间戳
# # RichTextItemClickEventDetail 属性值
名称 类型 必备 默认值 描述
ref string - 自定义数据
src string - <img/>图片链接
href string - <a/>超链接
# # RichTextItemClickEvent 方法
名称 类型 必填 默认值 描述
stopPropagation () => void - 阻止当前事件的进一步传播
preventDefault () => void - 阻止当前事件的默认行为

# # 示例

hello uni-app x

<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">
       <text class="uni-subtitle-text">selectable</text>
     </view>
     <view class="text-box">
       <rich-text :selectable="true"
         nodes="<span>hello uni-app x!</span><br/><span>uni-app x,终极跨平台方案</span>"></rich-text>
     </view>
   </view>
 </view>
</template>

<script>

</script>

<style>
 .text-box {
   padding: 40rpx 0;
   background-color: white;
 }
</style>

# # 兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
rich-text 5.0 3.9+ 9.0 -
selectable 5.0 x 3.91 9.0 x -

# # 参见

# Bug & Tips

  • HTML String支持常用但不是全部web样式。
  • HTML String类型的<img/>不支持自定义宽高,默认以rich-text组件宽度为基准等比缩放;节点列表类型的<img>/支持自定义宽高。