Skip to content

ifanrx/wxParser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

  • 注:wxParser 已提供小程序插件版 wxParser-plugin,使用起来更加简单快捷

步骤


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

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

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

示例


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

// 将 WXML 引入需要富文本解析的文件下
<import src="../../wxParser/index.wxml"/>
<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
        });
      }
    });

  }
})

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

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

注意


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

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