定制建站公司,jsp网站入门,有赞商城小程序入口,哈尔滨网站建设设计公司最近想在一个小程序里加入一个使用指南的页面#xff0c;考虑到数据存储和减少页面的开发工作量#xff0c;决定尝试在云存储里上传Markdown文件#xff0c;微信小程序端负责解析和渲染。小程序端使用到一个库Towxml。
Towxml
Towxml是一个可将HTML、Markdown转为微信小程…最近想在一个小程序里加入一个使用指南的页面考虑到数据存储和减少页面的开发工作量决定尝试在云存储里上传Markdown文件微信小程序端负责解析和渲染。小程序端使用到一个库Towxml。
Towxml
Towxml是一个可将HTML、Markdown转为微信小程序WXML(WeiXin Markup Language)的渲染库。用于解决在微信小程序中Markdown、HTML不能直接渲染的问题。 特色 Towxml 3.0 完整支持以下功能。当然在构建时可仅保留需要功能以减少体积大小和代码依赖。 支持echarts图表3.0✨支持LaTex数学公式3.0✨支持yuml流程图3.0✨支持按需构建3.0✨支持代码语法高亮、代码块行号显示支持emoji表情支持上标、下标、下划线、删除线、表格、视频、图片几乎绝大部分html元素……支持typographer字符替换支持多主题切换支持Markdown TodoList支持事件绑定这样允许自行扩展功能哟例如点击页面中的某个元素更新当前页面内容等...极致的中文排版优化支持前后解析数据 使用方法
1. 将构建出来的towxml并解压至小程序项目根目录下即小程序/towxml
2. 引入库/app.js
//app.js
App({// 引入towxml3.0解析方法towxml:require(/towxml/index)
})
3. 在页面配置文件中引入towxml组件 /pages/index/index.json
{usingComponents: {towxml:/towxml/towxml}
}
4. 在页面中插入组件/pages/index/index.wxml
!--index.wxml--
view classcontainertowxml nodes{{article}}/
/view
5. 解析内容并使用/pages/index/index.js
//获取应用实例
const app getApp();
Page({data: {isLoading: true, // 判断是否尚在加载中article: {} // 内容数据},onLoad: function () {let result app.towxml(# Markdown,markdown,{base:https://xxx.com, // 相对资源的base路径theme:dark, // 主题默认lightevents:{ // 为元素绑定的事件方法tap:(e){console.log(tap,e);}}});// 更新解析数据this.setData({article:result,isLoading: false});}
})
云开发
我们需要将写好的Markdown文件拖入云存储并且在同一级目录添加一个images文件夹。把Markdown中用到的图片拖入其中。然后在需要渲染的页面先下载Markdown文件
wx.cloud.downloadFile({fileID: cloud://demo-dev-lnhec.6675-demo-dev-lnhec-1302677061/ads/markdown.md}).then(res {console.log(res.tempFilePath)let fs wx.getFileSystemManager()let result fs.readFileSync(res.tempFilePath,utf-8)this.renderMarkdown(result)})
然后在renderMarkdown需要给towxml指定图片文件夹所在的父目录作为base地址base地址是所有静态相对资源的base路径这个地址不仅适用于http地址也适用于云存储地址。
renderMarkdown(markdown){let result app.towxml(markdown,markdown,{base:cloud://demo-dev-lnhec.6675-demo-dev-lnhec-1302677061/ads, // 相对资源的base路径theme:light, // 主题默认lightevents:{ // 为元素绑定的事件方法tap:(e){console.log(tap,e);}}})// 更新解析数据this.setData({article:result,isLoading: false});},
最后我们来看看渲染结果 可以看到Markdown里的图片链接成功渲染出来了。
总结
本文介绍通过将Towxml与云存储结合在微信小程序中渲染Markdown文件快速开发容易维护的QA、教程页面。
