更新记录
0.0.1(2026-05-02)
新增
- 新增富文本渲染组件
zr-html。
- 支持基础 HTML 内容渲染。
- 支持过滤
<script> 脚本内容。
- 支持过滤
onxxx 危险事件属性。
- 支持过滤
/code> 危险链接。
- 支持渲染完成事件和链接点击事件。
- 支持
getText() 提取纯文本。
优化
- 补充完整首页 demo,覆盖文章富文本、安全过滤、渲染状态和纯文本提取截图场景。
- 补充详情页级
readme.md,完善 API、事件、方法、平台兼容性和安全边界说明。
- 完善插件市场发布配置、平台兼容性、授权价格和文档说明。
注意
- 当前安全过滤为基础正则方案,不是完整 HTML Sanitizer。
- 复杂表格、代码块、图片预览建议后续版本补强。
平台兼容性
uni-app(5.08)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| √ |
√ |
√ |
√ |
√ |
- |
5.0 |
12 |
- |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
√ |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
uni-app x(5.08)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| √ |
√ |
5.0 |
12 |
- |
- |
其他
富文本渲染组件
zhuanz-richhtml 提供基础 HTML 渲染、安全过滤、链接点击和纯文本提取能力,适合公告详情、协议内容、图文详情和 CMS 内容展示。
组件
核心能力
- 基础 HTML 渲染。
<script> 脚本过滤。
onxxx 危险事件属性过滤。
/code> 危险链接过滤。
- 渲染完成事件。
- 链接点击事件。
- 纯文本提取
getText()。
安装路径
uni_modules/zhuanz-richhtml
基础示例
<template>
<zr-html ref="html" :content="content" @ready="onReady" @linkClick="onLinkClick" />
</template>
<script>
export default {
data() {
return {
content: '<h2>公告标题</h2><p>这里是富文本内容。</p>'
}
},
methods: {
onReady() {},
onLinkClick(e) {},
getPlainText() {
return this.$refs.html.getText()
}
}
}
</script>
Props
| 属性 |
类型 |
默认值 |
说明 |
content |
String |
'' |
HTML 字符串 |
safeMode |
Boolean |
true |
是否开启基础安全过滤 |
Events
| 事件 |
说明 |
ready |
渲染完成 |
error |
错误事件 |
linkClick |
链接点击事件 |
Methods
| 方法 |
说明 |
getText() |
获取过滤标签后的纯文本 |
setContent(html) |
当前版本提示通过 content 属性更新 |
平台兼容性
- uni-app Vue2 / Vue3:支持。
- H5:支持。
- App Vue:支持。
- 微信小程序:支持。
- 支付宝小程序:支持。
- uni-app x:支持 Web 和 App,需按实际项目运行环境验证。
注意事项
- 当前安全过滤为基础正则方案,适合普通内容展示。
- 不建议将其宣传为完整 HTML Sanitizer。
- 对复杂表格、代码块、图片预览等重内容场景,建议后续版本扩展。