Skip to content

Latest commit

 

History

History
executable file
·
75 lines (56 loc) · 2.54 KB

README.md

File metadata and controls

executable file
·
75 lines (56 loc) · 2.54 KB

步骤


  1. wxParser 目录放到小程序项目的根目录下
  2. 在需要富文本解析的 SWAN 内引入 wxParser/index.swan
  3. 在页面 JS 文件内使用 wxParser.parse(options) 方法解析 HTML 内容
  4. 在小程序项目根目录的 app.css 内引入 wxParser 的默认样式库

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

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

示例


swan:在需要用到富文本解析的文件夹下的 swan 中引入 wxParser/index.swan

// 将 swan 引入需要富文本解析的文件下
<import src="../../wxParser/index.swan"/>
<view class="wxParser">
  <template is="wxParser" data="{{wxParserData:richText.nodes}}"/>
</view>

JS:在需要用到富文本解析的文件夹下的 JS 中引入 wxParser 渲染引擎

const wxParser = require('../../wxParser/index');

Page({
  onLoad: function () {
    wxParser.parse({
      bind: 'richText',
      html: `<div style="color: #f00;">hello, wxParser!</div>`,
      target: this,
      enablePreviewImage: false, // 禁用图片预览功能
      tapLink: (url) => { // 点击超链接时的回调函数
        // url 就是 HTML 富文本中 a 标签的 href 属性值
        // 这里可以自定义点击事件逻辑,比如页面跳转
        wx.navigateTo({
          url
        });
      }
    });

  }
})

css:在需要使用 wxparser 的页面的 css 文件中引入 wxParser 样式库,或者直接在根目录的 app.css 内引入

@import '../../wxParser/index.css'

注意


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

*说明:该项目是基于 wxparse 做的改造,主要用于把在 知晓云 中的 富文本编辑器 编辑的内容,展示到百度小程序上