DOM
Element.append() 方法在当前 Element 的最后一个子节点之后插入一组 Node 对象或字符串对象。被插入的字符串对象等价为 Text 节点。
其与 Node.appendChild() 的差异:
Element.append()允许附加字符串对象,而Node.appendChild()只接受 Node 对象。Element.append()没有返回值,而Node.appendChild()返回附加的 Node 对象。Element.append()可以附加多个节点和字符串,而Node.appendChild()只能附加一个节点。
语法
append(param1)
append(param1, param2)
append(param1, param2, /* …, */ paramN)
参数
param1、…、paramN- : 一组要插入的 Node 或字符串对象。
返回值
无(undefined)。
异常
HierarchyRequestErrorDOMException- : 当层次结构中的指定位置不能插入节点时抛出该异常。
示例
附加元素
let div = document.createElement("div");
let p = document.createElement("p");
div.append(p);
console.log(div.childNodes); // NodeList [ <p> ]
附加文本
let div = document.createElement("div");
div.append("一些文本");
console.log(div.textContent); // "一些文本"
附加元素和文本
let div = document.createElement("div");
let p = document.createElement("p");
div.append("一些文本", p);
console.log(div.childNodes); // NodeList [ #text "一些文本", <p> ]
append 是不可绑定作用域方法
append() 方法无法被绑定到 with 语句的作用域中。参见 Symbol.unscopables 以了解更多信息。
let div = document.createElement("div");
with (div) {
append("foo");
}
// ReferenceError: append is not defined
规范
浏览器兼容性
参见
- Element.prepend()
- Node.appendChild()
- Element.after()
- Element.insertAdjacentElement()
- NodeList
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
