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 属性值
RichTextItemClickEventDetail 属性值
名称 | 类型 | 必备 | 默认值 | 描述 |
ref | string | 否 | - | 自定义数据 |
src | string | 否 | - | <img/>图片链接 |
href | string | 否 | - | <a/>超链接 |
RichTextItemClickEvent 方法
名称 | 类型 | 必填 | 默认值 | 描述 |
stopPropagation | () => void | 是 | - | 阻止当前事件的进一步传播 |
preventDefault | () => void | 是 | - | 阻止当前事件的默认行为 |
示例
hello uni-app x
兼容性
| 安卓系统版本 | 安卓 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>/
支持自定义宽高。