大网数据广告活动
Web 标准与前端开发

Element:insertAdjacentElement() 方法

· 52CE 我爱测

Element 接口的 **`insertAdjacentElement()`** 方法将一个给定的元素节点插入到相对于当前元素的指定位置。

DOM

Element 接口的 insertAdjacentElement() 方法将一个给定的元素节点插入到相对于当前元素的指定位置。

语法

insertAdjacentElement(position, element)
  • position

    • : 表示相对于 targetElement 的位置的字符串;必须是以下字符串之一(大小写不敏感):
      • 'beforebegin':targetElement 之前。
      • 'afterbegin':targetElement 内部的第一个子节点之前。
      • 'beforeend':targetElement 内部的最后一个子节点之后。
      • 'afterend':targetElement 之后。
  • element

    • : 要插入到树中的元素。

返回值

插入的元素,插入失败则返回 null。

异常

  • SyntaxError DOMException
    • : 如果指定的 position 不是可识别的值,则抛出该异常。
  • TypeError
    • : 如果指定的 element 不是有效的元素,则抛出该异常。

位置名称的可视化


<p>
  
  foo
  
</p>

[!NOTE] 只有当节点处于 DOM 树中且有一个父元素时 beforebegin 和 afterend 才会生效。

示例

beforeBtn.addEventListener("click", () => {
  const tempDiv = document.createElement("div");
  tempDiv.style.backgroundColor = randomColor();
  if (activeElem) {
    activeElem.insertAdjacentElement("beforebegin", tempDiv);
  }
  setListener(tempDiv);
});

afterBtn.addEventListener("click", () => {
  const tempDiv = document.createElement("div");
  tempDiv.style.backgroundColor = randomColor();
  if (activeElem) {
    activeElem.insertAdjacentElement("afterend", tempDiv);
  }
  setListener(tempDiv);
});

看看我们在 Github(也可以参考源码)上的 insertAdjacentElement.html 演示。在一个容器中我们有一组 div 元素。点击其中一个 div 时,这个容器会处于选中状态,然后你就可以按下 Insert before 或 Insert after 按钮,通过 insertAdjacentElement() 方法来把一个新的 div 插入到选中的元素前面或者后面。

规范

浏览器兼容性

参见

  • Element.insertAdjacentHTML()
  • Element.insertAdjacentText()
  • Node.insertBefore()(与 beforebegin 类似,但参数不同)
  • Node.appendChild()(与 beforeend 效果相同)

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。