uniapp实现微信小程序富文本之mp-html插件
- 1 文章背景
- 1.1 正则表达式
- 1.2 mp-html插件
- 1.3 uniapp
- 2 过程详解
- 2.1 下载mp-html插件
- 2.2 项目中引入mp-html
- 2.3 引入正则规范图片自适应
- 2.4 效果展示
- 3 全部代码
1 文章背景
1.1 正则表达式
正则表达式,又称规则表达式,(Regular Expression,在代码中常简写为regex、regexp或RE),是一种文本模式,包括普通字符(例如,a 到 z 之间的字母)和特殊字符(称为"元字符"),是计算机科学的一个概念。正则表达式使用单个字符串来描述、匹配一系列匹配某个句法规则的字符串,通常被用来检索、替换那些符合某个模式(规则)的文本。
许多程序设计语言都支持利用正则表达式进行字符串操作。例如,在Perl中就内建了一个功能强大的正则表达式引擎。正则表达式这个概念最初是由Unix中的工具软件(例如sed和grep)普及开来的,后来在广泛运用于Scala 、PHP、C# 、Java、C++ 、Objective-c、Perl 、Swift、VBScript 、Javascript、Ruby 以及Python等等。正则表达式通常缩写成“regex”,单数有regexp、regex,复数有regexps、regexes、regexen。
1.2 mp-html插件
功能介绍
- 支持大部分 html 实体
- 支持锚点跳转、长按复制等丰富功能
- 支持设置占位图(加载中、出错时、预览时)
- 支持丰富的标签(包括 table、video、svg 等)
- 支持在多个主流的小程序平台和 uni-app 中使用
- 支持丰富的事件效果(自动预览图片、链接处理等)
- 丰富的插件(关键词搜索、内容编辑、latex 公式等)
- 效率高、容错性强且轻量化(≈25KB,9KB gzipped)
1.3 uniapp
uni-app(uni,读you ni,是统一的意思) [2]是一个使用Vue.js开发所有前端应用的框架,开发者编写一套代码,可发布到iOS、Android、Web(响应式)、以及各种小程序、快应用等多个平台。
产生背景:
DCloud于2012年开始研发小程序技术,优化webview的功能和性能,推出了HBuilder开发工具,为后续产业化做准备。
2015年,DCloud正式商用了自己的小程序,产品名为“流应用”,它不是模式的轻应用,而是能接近原生功能、性能的App,并且即点即用,第一次使用时可以做到边下载边使用。
2 过程详解
2.1 下载mp-html插件
-
插件市场:
mp-html一个强大的小程序富文本组件 -
mp-html 富文本组件
mp-html 富文本组件【全端支持,支持编辑、latex等扩展】 -
mp-html git 地址
mp-html-GitHub地址 -
直接导入Hbuilder之后就可以了
当然,插件市场也有对应教程,可按教程操作。
2.2 项目中引入mp-html
- 接口数据展示
{"total": 18,"rows": [{"createBy": "超级管理员","createTime": "2024-01-11 15:05:49","updateBy": "超级管理员","updateTime": "2024-01-12 15:42:53","remark": null,"productId": 25,"summaryId": 206,"summaryName": "环保信息化软件研发","productTitle": "【企业】e云管家","productType": "text","productContent": "<p><img src=\"https://sdddeesp.com/prod-api/upload/2024/01/12/54231A025.jpg\"></p>","status": "0","coverPhoto": "/upload/2024/01/12/154226A024.jpg","intro": "免费版污染源在线查看、报警终端!","delFlag": "0"},}
其中重要的参数:
productType
:传递的类型包括:link\text
productContent
:文章的内容包括富文本和连接。
- 引入类型
mp-html 引入
<template><view class="content"><view v-if="articleDetail.productType == 'link'" class="container"><!-- 接受的是连接格式 --><web-view :src="articleDetail.productContent"></web-view></view><view v-else class="are-contnet"><!--接受的不是连接格式 --><mp-html :content="strings" selectable="true" show-img-menu="true" /></view></view>
</template>
data中重要参数:
data() {return {strings: '', //用于富文本中间传递的参数}
},
method方法:
methods: {get_Product(articleTitle){// 请求右侧文章列表uni.request({url: 你的接口url,method: "GET",success: (article_res) => {if(article_res.data.total!=0){let artical_data = article_res.data.rows[0];this.strings = artical_data.productContent,//这个是必须的,需要将文章内容传递为Strings。}},fail: () => {},complete: () => {}});},
}
通过以上的配置信息,基本可以实现数据的展示,但是还需要一定的优化,有些文本传递的HTML数据,可能有些自带的样式,这就造成数据展示的混乱。
2.3 引入正则规范图片自适应
首先需要在模板里设置一个过滤器
<mp-html :content="strings|formatRichText" selectable="true" show-img-menu="true"/>
过滤器方法:
注意:这个过滤器方法是和onLoad()
,和methods
方法同级别的。里面用的是一些正则表达式进行筛选。
onLoad: () {},
filters: {/*** 处理富文本里的图片宽度自适应* 1.去掉img标签里的style、width、height属性* 2.img标签添加style属性:max-width:100%;height:auto* 3.修改所有style里的width属性为max-width:100%* 4.去掉<br/>标签* @param html* @returns {void|string|*}* */formatRichText(html) { //控制小程序中图片大小let newContent = html.replace(/<img[^>]*>/gi, function(match, capture) {match = match.replace(/style="[^"]+"/gi, '').replace(/style='[^']+'/gi, '');match = match.replace(/width="[^"]+"/gi, '').replace(/width='[^']+'/gi, '');match = match.replace(/height="[^"]+"/gi, '').replace(/height='[^']+'/gi, '');return match;});newContent = newContent.replace(/style="[^"]+"/gi, function(match, capture) {match = match.replace(/width:[^;]+;/gi, 'max-width:100%;').replace(/width:[^;]+;/gi,'max-width:100%;');return match;});newContent = newContent.replace(/<br[^>]*\/>/gi, '');newContent = newContent.replace(/\<img/gi,// '<img style="max-width:100%;height:auto;display:inline-block;margin:10rpx auto;" src="https://syqdxs.sdeesp.com');'<img style="max-width:100%;height:auto;display:inline-block;margin:10rpx auto;"');return newContent;}
},
methods: {},
上述需要介绍的一点:如果文章中的图片给的路径不是全路径怎么办?比如:
"productContent": "<p><img src=\"/upload/2024/01/12/A025.jpg\"></p>",
这样会造成mp-html在读取文章图片的时候,由于路径不对,找不到图片,从而不能显示,那该怎么办呢?
这就就要用到正则替换原来的一些内容。
需要用下面的方法对图片相同的地方进行替换
newContent = newContent.replace(/\<img src="/gi,'<img style="max-width:100%;height:auto;display:inline-block;margin:10rpx auto;" src="https://sdddeesp.com');return newContent;
- 上述正则的意思是
将文章中所有的<img src="
替换为:
<img style="max-width:100%;height:auto;display:inline-block;margin:10rpx auto;" src="https://sdddeesp.com
也就是将文中所有的标签的:
<img src=\"https://sdddeesp.com/prod-api/upload/2024/01/12/54231A025.jpg\">
替换为:
<img style="max-width:100%;height:auto;display:inline-block;margin:10rpx auto;" src=\"https://sdddeesp.com/prod-api/upload/2024/01/12/54231A025.jpg\”>
这样图片的路径就变成了全路径,
其他同类型的可是参考这个修改。
2.4 效果展示
3 全部代码
<template><view class="content"><view v-if="articleDetail.productType == 'link'" class="container"><!-- 接受的是连接格式 --><web-view :src="articleDetail.productContent"></web-view></view><view v-else class="are-contnet"><!-- 接受的是其他格式 --><mp-html :content="strings|formatRichText" selectable="true" show-img-menu="true" /></view></view>
</template><script>export default {data() {return {strings: '', //富文本}},onLoad: function(options) {uni.showLoading({title: '正在加载',mask: false});let articleTitleId = options.articleTitleId this.get_Product(articleTitleId )},filters: {/*** 处理富文本里的图片宽度自适应* 1.去掉img标签里的style、width、height属性* 2.img标签添加style属性:max-width:100%;height:auto* 3.修改所有style里的width属性为max-width:100%* 4.去掉<br/>标签* @param html* @returns {void|string|*}* */formatRichText(html) { //控制小程序中图片大小let newContent = html.replace(/<img[^>]*>/gi, function(match, capture) {match = match.replace(/style="[^"]+"/gi, '').replace(/style='[^']+'/gi, '');match = match.replace(/width="[^"]+"/gi, '').replace(/width='[^']+'/gi, '');match = match.replace(/height="[^"]+"/gi, '').replace(/height='[^']+'/gi, '');return match;});newContent = newContent.replace(/style="[^"]+"/gi, function(match, capture) {match = match.replace(/width:[^;]+;/gi, 'max-width:100%;').replace(/width:[^;]+;/gi,'max-width:100%;');return match;});newContent = newContent.replace(/<br[^>]*\/>/gi, '');newContent = newContent.replace(/\<img/gi,'<img style="max-width:100%;height:auto;display:inline-block;margin:10rpx auto;"');return newContent;}},methods: {// 返回上一页back() {uni.navigateBack({delta: 1})},get_Product(articleTitleId ){// 请求右侧文章列表uni.request({url: '你的URL连接'+articleTitleId ,method: "GET",success: (article_res) => {if(article_res.data.total!=0){let artical_data = article_res.data.rows[0];this.articleDetail = artical_data;this.strings = artical_data.productContent,console.log("articleDetail",this.articleDetail);uni.hideLoading()}},fail: () => {},complete: () => {}});},}}
</script><style>.content {padding: 10upx 2%;width: 96%; flex-wrap: wrap;}.title {line-height: 2em;font-weight: 700;font-size: 38upx;}.art-content {line-height: 2em;}.container {width: 100%;height: 100vh;}
</style>
- articleTitleId 上个页面传递的参数
感谢能看到这里的没一位大佬,我在此宣布:下班!