渲染内容

插件版使用指南

使用步骤

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

wxParser 参数说明

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

参数类型必填说明
bindString要绑定的数据名称
htmlStringHTML 内容
targetObject绑定数据的模块对象
enablePreviewImageBoolean是否启用富文本内的图片预览功能,默认是
tapLinkFunction点击超链接时的回调函数

示例

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 的默认样式(因为内容库样式会有定期更新),应该新增一个样式补丁文件用来自定义样式