DOM
Node 接口的 insertBefore() 方法是将一个节点插入到指定父节点的子节点中,并位于参考节点之前。
如果给定的节点已经存在于文档中,insertBefore() 会将其从当前位置移动到新位置。(也就是说,它会在附加到指定的新父节点之前自动从现有的父节点中移除。)
这意味着一个节点不能同时存在于文档的两个位置。
[!NOTE] 可以使用 Node.cloneNode() 在将节点追加到新的父节点之前先对其进行复制。请注意,使用
cloneNode()进行复制的节点不会自动保持同步。
如果给定的子节点是 DocumentFragment,则该 DocumentFragment 的全部内容将被移动到指定父节点的子节点列表中。
语法
insertBefore(newNode, referenceNode)
参数
newNode- : 要插入的节点。
referenceNode
返回值
返回添加的子节点(除非 newNode 是 DocumentFragment——将返回空的 DocumentFragment)。
异常
预插入有效性
示例
示例 1
<div id="parentElement">
<span id="childElement">foo bar</span>
</div>
<script>
// 创建要插入的新节点
const newNode = document.createElement("span");
// 获取父节点的引用
const parentDiv = document.getElementById("childElement").parentNode;
// 开始测试用例 [ 1 ]:存在 childElement(全部正常运行)
let sp2 = document.getElementById("childElement");
parentDiv.insertBefore(newNode, sp2);
// 结束测试用例 [ 1 ]
// 开始测试案例 [ 2 ]:childElement 类型未定义
sp2 = undefined; // id 为“childElement”的节点不存在
parentDiv.insertBefore(newNode, sp2); // 隐式动态转换为节点类型
// 结束测试用例 [ 2 ]
// 开始测试案例 [ 3 ]:childElement 的类型为“undefined”(字符串)
sp2 = "undefined"; // id 为“childElement”的节点不存在
parentDiv.insertBefore(newNode, sp2); // 生成“Type Error: Invalid Argument”
// 结束测试用例 [ 3 ]
</script>
示例 2
<div id="parentElement">
<span id="childElement">foo bar</span>
</div>
<script>
// 创建新的普通 <span> 元素
let sp1 = document.createElement("span");
// 获取引用元素
let sp2 = document.getElementById("childElement");
// 获取父元素
let parentDiv = sp2.parentNode;
// 在 sp2 之前插入新元素
parentDiv.insertBefore(sp1, sp2);
</script>
[!NOTE] 没有
insertAfter()方法。可以通过将insertBefore方法与 Node.nextSibling 结合使用来模拟实现。在前面的例子中,可以使用以下方法在sp2后面插入sp1:parentDiv.insertBefore(sp1, sp2.nextSibling);如果
sp2没有下一个兄弟节点,那么它必须是最后一个子节点——sp2.nextSibling返回null,此时sp1将被插入到子节点列表的末尾(紧接在sp2之后)。
示例 3
使用 Node/firstChild 属性,在第一个子元素之前插入一个元素。
// 获取父元素
let parentElement = document.getElementById("parentElement");
// 获取父元素的第一个子元素
let theFirstChild = parentElement.firstChild;
// 创建新元素
let newElement = document.createElement("div");
// 在第一个子元素之前插入新元素
parentElement.insertBefore(newElement, theFirstChild);
如果元素没有第一个子元素,则 firstChild 为 null。该元素仍然会被追加到父元素的最后一个子元素之后。
由于父元素没有第一个子元素,所以也没有最后一个子元素。因此,新插入的元素是唯一的元素。
规范
浏览器兼容性
参见
- Node.removeChild()
- Node.replaceChild()
- Node.appendChild()
- Node.hasChildNodes()
- Element.insertAdjacentElement()
- Element.prepend()
- Element.before()
- Element.after()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
