• 渲染内容
    • 使用步骤
    • wxParser 参数说明
    • 示例

    渲染内容

    使用步骤

    1. 下载 小程序内容渲染包 wxParser
    2. wxParser 目录放到小程序项目的根目录下
    3. 在需要富文本解析的的 WXML 内引入 wxParser/index.wxml
    4. 在页面 JS 文件内使用 wxParser.parse(options) 方法解析 HTML 内容
    5. 在需要展示富文本内容的页面的 wxss 文件内引入 wxParser 的默认样式库 wxParser/index.wxss,或者在小程序项目根目录的 app.wxss 中引入

    wxParser 参数说明

    wxParser.parse(options) 方法的 options 参数说明

    参数 类型 必填 说明
    bind String 要绑定的数据名称
    html String HTML 内容
    target Object 绑定数据的模块对象
    enablePreviewImage Boolean 是否启用富文本内的图片预览功能,默认是
    tapLink Function 点击超链接时的回调函数

    示例

    WXML

    1. <import src="../../wxParser/index.wxml"/>
    2. <view class="wxParser">
    3. <template is="wxParser" data="{{wxParserData:richText.nodes}}"/>
    4. </view>

    JS

    1. const wxParser = require('../../wxParser/index')
    2. Page({
    3. data: {},
    4. onLoad: function () {
    5. let that = this
    6. let html = `<div style="color: #f00;">hello, wxParser!</div>`
    7. wxParser.parse({
    8. bind: 'richText',
    9. html: html,
    10. target: that,
    11. enablePreviewImage: false, // 禁用图片预览功能
    12. tapLink: (url) => { // 点击超链接时的回调函数
    13. // url 就是 HTML 富文本中 a 标签的 href 属性值
    14. // 这里可以自定义点击事件逻辑,比如页面跳转
    15. wx.navigateTo({
    16. url
    17. })
    18. }
    19. })
    20. }
    21. })

    WXSS

    1. @import '../wxParser/index.wxss'

    同时,你可以下载我们在 github 上上传的一个简单的 demo 来作参考

    注:

    • JS 中的 richText 可以自定义,但是必须要与 WXML 中的 richText 对应
    • 推荐把 template 放到 <view class="wxParser"></view> 内部,这样可以受 wxParser 控制并具有 wxParser 的一些默认样式
    • 不建议直接修改 wxParser 的默认样式(因为内容库样式会有定期更新),应该新增一个样式补丁文件用来自定义样式