uniapp实现微信小程序富文本之mp-html插件详解

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": "
",
            "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.去掉
标签
	 * @param html
	 * @returns {void|string|*}
	 * 
	 */
	formatRichText(html) { //控制小程序中图片大小
		let newContent = html.replace(/]*>/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(/]*\/>/gi, '');
		newContent = newContent.replace(/\/gi,
			// '');
		return newContent;
	}
},
methods: {},

上述需要介绍的一点：如果文章中的图片给的路径不是全路径怎么办？比如：

 "productContent": "
",

这样会造成mp-html在读取文章图片的时候，由于路径不对，找不到图片，从而不能显示，那该怎么办呢？
这就就要用到正则替换原来的一些内容。

需要用下面的方法对图片相同的地方进行替换

newContent = newContent.replace(/\/gi,
		');
	return newContent;

• 上述正则的意思是
  将文章中所有的<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.去掉
  标签
  			 * @param html
  			 * @returns {void|string|*}
  			 * 
  			 */
  			formatRichText(html) { //控制小程序中图片大小
  				let newContent = html.replace(/]*>/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(/]*\/>/gi, '');
  				newContent = newContent.replace(/\/gi,
  					');
  				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 上个页面传递的参数

  感谢能看到这里的没一位大佬，我在此宣布：下班！