html 中不存在 _html 语法,它既不是标签、属性,也不是合法自定义元素名;常见于 js 私有属性、模板变量或开发者自定义键名,与 html 语法无关。

HTML 里怎么写 _html 这种命名?根本不存在这个语法
HTML 标准里没有 _html 这种写法,它不是标签、不是属性、也不是合法的自定义元素名。你看到的 _html,大概率是以下三种情况之一:
• 某个 JS 库(比如早期 Vue 选项 API)里用作内部标识的私有属性名,比如 vm._html;
• 某个模板引擎(如 EJS、Nunjucks)的特殊变量或过滤器名,但需配合具体上下文;
• 开发者自己写的 JS 变量或对象键名,比如 data._html = '<div>xxx</div>',纯属自定义,和 HTML 语法无关。
想在 HTML 中插入动态 HTML 字符串?别直接拼接 _html
常见错误:把后端返回的 HTML 字符串赋给 innerHTML,同时变量名起成 _html,误以为这是“HTML 专用写法”。其实关键不在名字,而在如何安全插入:
- 用
element.innerHTML = htmlString是可行的,但必须确保htmlString来源可信,否则 XSS 风险极高 - 现代推荐用
element.setHTML(htmlString)(仅 Chromium 110+ 实验性支持),或更稳妥地用DOMParser+ 白名单过滤 - Vue/React 等框架中,
v-html或dangerouslySetInnerHTML才是对应能力,_html不是它们的替代品
_html 出现在报错里?检查是不是 JS 对象属性访问错了
典型错误现象:Cannot read property '_html' of undefined。这说明你在某处写了类似 obj._html,但 obj 是 null 或 undefined,不是 HTML 写法问题,而是 JS 运行时逻辑缺陷:
- 确认对象初始化是否完整,比如
const vm = new Vue({ el: '#app' })后再访问vm._html(不推荐依赖私有属性) - 避免在组件未挂载完成前读取渲染相关私有字段,
mounted钩子之后才可能有 - TypeScript 下,
_html这类下划线开头的属性默认不被类型定义包含,强行访问会报错或失去类型提示
想让 HTML 支持下划线开头的自定义属性?用 data- 前缀
HTML5 允许自定义属性,但必须以 data- 开头,比如 data-html 或 data-_html(注意:连字符后不能紧跟数字或下划线,data-_html 实际是非法的):
立即学习“前端免费学习笔记(深入)”;
- 合法写法:
<div data-html-content="<p>ok</p>"></div> - 获取方式:
el.dataset.htmlContent(自动驼峰化),不是el._html - 浏览器会忽略非
data-开头的自定义属性,_html直接写在标签上不会被解析,也不进 DOM 属性集合
真正容易被忽略的是:下划线在 HTML 属性名里没有特殊含义,它既不触发任何解析逻辑,也不代表“私有”或“内部”,只是普通字符——而 JS 里下划线开头的习惯,和 HTML 完全不互通。










