v-html 是 Vue 中唯一直接渲染 HTML 字符串的指令,不转义、不校验、不编译,存在 XSS 风险;仅适用于已清洗的可信内容,禁用在用户输入场景,推荐优先使用文本插值或 Markdown/AST 替代。

v-html 会直接执行 script 标签,不校验来源,用错就 XSS。它不是“安全渲染 HTML”的方案,而是“信任该内容已清洗过”的快捷通道。
Vue 里用 v-html 渲染富文本,但图片不显示
常见现象是 <img src="xxx" alt="HTML动态内容富文本渲染的教程" > 在页面上留空或报 404。根本原因不是 v-html 失效,而是路径没走通:
- 本地图片(如
src="./assets/logo.png")在v-html中无效——Vue 模板编译时不会处理字符串里的相对路径 - 后端返回的 HTML 若含相对路径,需在 JS 层统一补前缀,比如:
html.replace(/src="([^"]*)"/g, (_, p1) => `src="${baseUrl}${p1}"`) - 图片跨域时,
<img alt="HTML动态内容富文本渲染的教程" >本身不报错,但控制台会显示 CORS 被拒;此时需服务端配Access-Control-Allow-Origin或改用代理
微信小程序 rich-text 组件里列表缩进失效
原生 rich-text 对 <ul></ul>/<ol></ol> 仅做节点识别,不继承 CSS 缩进规则。表现是所有 <li> 顶格对齐,无层级感。
- 必须手动加内联样式,例如:
<ul style="padding-left: 40rpx;"><li>第一项</li></ul> - 嵌套列表要逐层递增
padding-left,不能依赖 class 或外部样式表 - 如果后端返回的是纯标签无样式,前端解析时得用正则或 DOMParser 遍历
ul深度,动态注入style属性
mp-html 动态更新 content 后样式丢失
调用 setContent() 后字体变小、行高塌陷、颜色还原成默认值,通常是因为组件未触发样式重计算。
立即学习“前端免费学习笔记(深入)”;
-
mp-html的content属性是单向绑定,直接改 data 里的字符串不会触发更新,必须显式调用mpHtml.setContent(htmlStr) - 若在
setData回调里调用setContent,需确保组件实例已 ready,可用selectComponent后加nextTick延迟执行 - 自定义样式被覆盖:mp-html 默认启用样式隔离,若传入的 HTML 含
style属性,需在组件配置中设useCustomStyle=true,否则内联样式会被过滤
真正难的不是“怎么让 HTML 显示出来”,而是“怎么让不同平台对同一段 HTML 做出一致的样式解释”。rich-text 不认 table,v-html 不理 scoped,mp-html 默认过滤 style——这些不是 bug,是设计取舍。选型前先列清楚哪些标签必须支持、哪些交互不可妥协,比堆配置重要得多。



















