createElement+appendChild安全插入元素,避免XSS和解析错乱;innerHTML仅适用于完全可信的静态模板,处理用户输入必须转义或过滤。

用 createElement + appendChild 安全插入元素
直接拼接字符串再赋值给 innerHTML 看似简单,但遇到用户输入或含特殊字符的数据时,容易触发 XSS 或解析错乱。更稳妥的做法是用原生 DOM API 逐个创建、设置、挂载。
常见错误现象:document.write() 在页面加载完成后调用会清空整个文档;innerHTML = ' 未转义就插入,导致脚本执行或标签闭合异常。
- 优先使用
document.createElement('div')创建节点 - 用
element.textContent填充纯文本(自动转义) - 用
element.setAttribute('class', 'item')设置属性,而非拼字符串 - 批量插入多个节点时,先用
document.createDocumentFragment()中转,减少重排次数
用 innerHTML 时必须确认内容可信
innerHTML 适合渲染完全由开发者控制的静态模板片段,比如从 JSON Schema 生成的表单结构,或预定义的提示文案。一旦涉及后端返回字段、URL 参数、用户评论等内容,就必须过滤或转义。
使用场景:后台配置的运营弹窗文案、固定格式的统计卡片 HTML 模板、无交互的说明性内容。
- 若数据来自
fetch,且已明确是安全 HTML 片段,可直接赋值:el.innerHTML = data.htmlContent - 若含变量占位,建议用
template标签 +content.cloneNode(true)替代字符串插值 - 永远不要对
response.json()的结果不做校验就塞进innerHTML—— 漏掉这步常导致TypeError: Cannot set property 'innerHTML' of null
jQuery 的 each + text() 是 JSON 渲染表格的安全起点
当你要把 API 返回的 data 数组快速转成表格,又不想引入 Vue/React,jQuery 的双层 $.each 是轻量可行方案,关键是默认用 .text() 而非 .html()。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
容易踩的坑:把邮箱、链接等需要保留 HTML 结构的字段也用 .text(),结果渲染成纯文本;或者为图省事全局改用 .html(),埋下 XSS 隐患。
- 对通用字段(姓名、ID、状态)用
$td.text(value) - 对需富文本的字段(如带
的操作列),单独判断 key 名,再用.html(safeHtml) - 表头自动生成时,别直接用
Object.keys(data[0])—— 若数组为空,会报错;应先if (data.length) { ... }
动态内容依赖状态时,别硬写 if-else 切换 DOM
页面要根据 loading / error / success 三态切换内容,手写一堆 if (status === 'loading') { el.innerHTML = '...' } 很快失控。真正可持续的方式是让 DOM 变化由状态驱动,而非命令式操作。
性能影响:频繁修改 innerHTML 触发多次重排重绘;而用 CSS 属性控制显隐(如 data-status + [data-status="loading"] .content { display: none; })几乎零开销。
- 把状态存在
el.dataset.status,统一由 CSS 控制各区块显隐 - 用
...存结构,避免重复解析 HTML 字符串 - 缓存高频访问节点,例如
const $list = document.querySelector('#item-list'),避免每次重查 DOM
最常被忽略的一点:动态内容是否在首次渲染后还能响应后续数据变更?如果只是“生成一次”,那 createElement 和 innerHTML 都能搞定;但只要涉及更新、删除、排序,就得考虑节点复用、事件代理、key 标识这些深层机制 —— 此时原生方案成本陡增,该评估是否引入轻量响应式库了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










