今天为大家带来的是一个用于在微信小程序中渲染html和Markdown的富文本组件,而且支持代码高亮,它就是html2wxml!
https://github.com/qwqoffice/html2wxml
1、打开小程序管理后台,转到设置 - 第三方服务,点击添加插件
2、搜索 html2wxml ,选中并添加
3、添加成功
4、回到小程序开发环境,编辑 app.json ,添加插件声明,最新版为 1.3.0
"plugins": {
\t"htmltowxml": {
\t\t"version": "1.3.0",
\t\t"provider": "wxa51b9c855ae38f3c"
\t}
}
5、在对应页面的 json 文件,比如首页 index.json,添加使用插件组件的声明
"usingComponents": {
\t"htmltowxml": "plugin://htmltowxml/view"
}
1、复制整个 html2wxml-component 文件夹到小程序目录
2、在对应页面的 json 文件,比如首页 index.json,添加使用组件的声明,注意路径
"usingComponents": {
\t"htmltowxml": "path/to/html2wxml-component/html2wxml"
}
1、复制整个 html2wxml-template 文件夹到小程序目录
2、在对应页面的 js 文件,比如首页 index.js,添加引用声明,并使用html2wxml方法进行数据绑定,注意路径,参数分别为绑定的数据名、已解析的富文本数据、当前页面对象和容器与屏幕边缘的单边的距离
var html2wxml = require('path/to/html2wxml-template/html2wxml.js');
html2wxml.html2wxml('article', res.data, this, 5);
3、在对应页面的 wxml 文件,比如首页 index.wxml,添加引用模板的声明,并使用模板,注意路径和绑定的数据名
4、在对应页面的 wxss 文件,比如首页 index.wxss或app.wxss, 引入样式表和你喜欢的代码高亮样式,注意路径
@import "path/to/html2wxml-template/html2wxml.wxss";
@import "path/to/html2wxml-template/highlight-styles/darcula.wxss";
// 将Page中的content数据作为HTML格式渲染
// 禁用代码高亮功能
// 禁用代码行号显示功能
// 代码高亮样式改为tomorrow
// 设置代码高亮检测语言 (最多6个,自行搭建服务不受限制)
// 对HTML数据中的img标签的相对路径补全域名
// 禁用加载中动画
// 将Page中的text数据作为Markdown格式渲染
// 直接渲染Page中的已经过解析的obj数据
富文本的解析默认是由QwqOffice完成,存在不稳定因素,你可以自行搭建解析服务或将解析组件引入到你的项目中。
1、复制整个 html2wxml-php 文件夹到项目目录中
2、引入类文件class.ToWXML.php
include( 'path/to/html2wxml-php/class.ToWXML.php' );
3、实例化html2wxml,进行解析并输出,示例:
$towxml = new ToWXML();
$json = $towxml->towxml( 'H1标题
', array(
\t'type' => 'html',
\t'highlight' => true,
\t'linenums' => true,
\t'imghost' => null,
\t'encode' => false,
\t'highlight_languages' => array( 'html', 'js', 'php', 'css' )
) );
echo json_encode( $json, JSON_UNESCAPED_UNICODE );