前言
專案中有個需求:在小程序裡顯示新聞內容。資料是透過接口從服務器讀取的富文本,格式為 HTML。問題是小程序預設並不支援直接渲染 HTML 字串,這時候就需要借助 wxParse 這個第三方庫。
GitHub 位址:https://github.com/icindy/wxParse
本地下載:https://xiazai.jb51.net/201704/yuanma/wxParse-master(jb51.net).rar

wxParse
下載完成後,我們只需要用到其中的 wxParse 資料夾,把它複製到專案目錄下即可。

1、在全域樣式檔 app.wxss 中引入 wxParse 的樣式表
@import "/page/wxParse/wxParse.wxss";
2、在需要載入 HTML 內容的頁面 JS 中引入 wxParse
var WxParse = require('../../wxParse/wxParse.js');
3、呼叫 WxParse.wxParse 方法設定 HTML 內容
/** * WxParse.wxParse(bindName, type, data, target, imagePadding) * 1. bindName 綁定的資料名(必填) * 2. type 可為 html 或 md(必填) * 3. data 傳入的具體資料(必填) * 4. target Page 物件,一般為 this(必填) * 5. imagePadding 圖片自適應時左右的單一 padding(預設 0,可選) */
Page({
data: {},
onLoad: function () {
var that = this;
wx.request({
url: '',
method: 'POST',
data: { 'id': 13 },
header: { 'content-type': 'application/json' },
success: function (res) {
var article = res.data[0].post;
WxParse.wxParse('article', 'html', article, that, 5);
}
})
}
})
4、在頁面中引用模板
<import src="../../wxParse/wxParse.wxml"/>
<template is="wxParse" data="{{wxParseData:article.nodes}}"/>
這樣就能在小程序中呈現 HTML 內容了。

· 引入路徑要與實際放置位置一致,../../ 的層級數很容易寫錯;
· 樣式表的 @import 只能寫在 app.wxss 中,寫在頁面 wxss 裡不會生效;
· 若富文本中含 table、iframe 等複雜結構,wxParse 的支援有限,可能需要事先在後端做標籤過濾;
· 新專案也可以直接評估原生 rich-text 組件,它支援的節點類型更標準,只是對自訂樣式的控制較弱。
總結
小程序渲染 HTML 的核心思路是「解析成節點樹,再用小程序原生組件重新渲染」。wxParse 幫你把這件事封裝好了,只要照四個步驟接入即可。