JavaScript 中 DOM 怎么通过 insertAdjacentHTML 在指定位置精确插入 HTML 片段

冬瑶姑娘_6598

冬瑶姑娘_6598

2026-08-23

701人浏览

原创

html-to-pptx
html-to-pptx

将多页 HTML 演示文稿转换为美化的 PPTX 文件,便于分享和分发。

下载
insertadjacenthtml是最常用且稳妥的dom插入方法,支持beforebegin、afterbegin、beforeend、afterend四个位置,不破坏现有结构,但需手动转义用户输入防xss。

javascript 中 dom 怎么通过 insertadjacenthtml 在指定位置精确插入 html 片段

insertAdjacentHTML 是 DOM 元素上一个非常精准、高效且不破坏现有事件绑定的插入方法。它不重新解析整个元素内容,只把 HTML 字符串解析后插入到指定位置,因此比 innerHTML += ... 安全、稳定得多。

四个合法位置参数:beforebegin、afterbegin、beforeend、afterend

该方法接收两个参数:position(字符串)和 text(HTML 字符串)。position 必须是以下四个值之一,区分大小写:

  • beforebegin:插入到目标元素自身之前(即作为其父元素的前一个兄弟节点)
  • afterbegin:插入到目标元素内部,作为其第一个子节点(等价于 prepend())
  • beforeend:插入到目标元素内部,作为其最后一个子节点(等价于 append() 或传统 innerHTML += 的效果,但更安全)
  • afterend:插入到目标元素自身之后(即作为其父元素的后一个兄弟节点)

实际用法示例与注意事项

假设有如下 HTML:

原始内容

你可以这样操作:

  • document.getElementById('box').insertAdjacentHTML('beforebegin', '<h2>标题</h2>'); → 在 <div id="box"> 外部上方插入 <li> <code>document.getElementById('box').insertAdjacentHTML('afterbegin', '<span>开头追加</span>'); → 插入到 <div> 内部最前面,成为第一个子节点 <li> <code>document.getElementById('box').insertAdjacentHTML('beforeend', '<hr>'); → 插入到 <div> 内部最后面,紧接在 <code><p></p> 后
  • document.getElementById('box').insertAdjacentHTML('afterend', '<p>后面内容</p>'); → 在
闭合标签之后插入

⚠️ 注意:如果传入非法 position(如 'top' 或大小写错误),会直接抛出 SyntaxError;HTML 字符串中若有脚本标签(<script></script>),默认不会执行——这是它的安全特性之一。

和 innerHTML += ... 的关键区别

很多人习惯用 el.innerHTML += htmlString,但这有严重隐患:

  • 会完整重写整个 innerHTML,导致所有已绑定的事件监听器丢失(即使没动对应子元素)
  • 可能意外清空用户输入(如 <input> 的 value 值或 <textarea></textarea> 的内容)
  • 性能较差,尤其对大结构反复拼接时

insertAdjacentHTML 只新增节点,不触碰已有子树,原生事件监听器、表单状态、焦点等全部保留。

配合模板字符串动态插入更实用

现代写法常结合模板字符串提升可读性:

const name = '小明';
const age = 25;
el.insertAdjacentHTML('beforeend', `
  • ${name}(${age}岁)
  • `);

    注意:仍需确保变量内容已做 HTML 转义(如用 textContent 替代或手动转义),避免 XSS。若内容来自用户,建议先创建文本节点或使用 DOMPurify 等库净化。

    Java免费学习笔记:立即使用
    解锁 Java 大师之旅:从入门到精通的终极指南

    相关文章

    HTML速学教程(入门课程)
    HTML速学教程(入门课程)

    HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

    下载

    相关标签:

    javascript java html

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    js获取数组长度的方法
    js获取数组长度的方法

    在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

    2023.06.20

    4426

    5

    js刷新当前页面
    js刷新当前页面

    js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

    2023.07.04

    1109

    3

    js四舍五入
    js四舍五入

    js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

    2023.07.04

    4324

    6

    js删除节点的方法
    js删除节点的方法

    js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

    2023.09.01

    880

    4

    JavaScript转义字符
    JavaScript转义字符

    JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

    2023.09.04

    1776

    5

    js生成随机数的方法
    js生成随机数的方法

    js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

    2023.09.04

    3185

    4

    如何启用JavaScript
    如何启用JavaScript

    JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

    2023.09.12

    4153

    6

    Js中Symbol类详解
    Js中Symbol类详解

    javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

    2023.09.20

    2680

    5

    java访问控制修饰符介绍
    java访问控制修饰符介绍

    java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

    2023.09.20

    868

    7

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    WebStorm 官方调试文档
    WebStorm 官方调试文档

    共0课时 | 0人学习

    React 教程
    React 教程

    共58课时 | 12万人学习

    TypeScript 教程
    TypeScript 教程

    共19课时 | 6.6万人学习