DIV CSS 佈局教程網

微信小程序中如何渲染 HTML 富文本內容(wxParse 實操)
編輯:JavaScript基礎知識     

前言

專案中有個需求:在小程序裡顯示新聞內容。資料是透過接口從服務器讀取的富文本,格式為 HTML。問題是小程序預設並不支援直接渲染 HTML 字串,這時候就需要借助 wxParse 這個第三方庫。

準備工作:下載 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 幫你把這件事封裝好了,只要照四個步驟接入即可。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved