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

Element:append() 方法

· 52CE 我爱测

`Element.append()`** 方法在当前 `Element` 的最后一个子节点之后插入一组 Node 对象或字符串对象。被插入的字符串对象等价为 Text 节点。

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)。

异常

  • HierarchyRequestError DOMException
    • : 当层次结构中的指定位置不能插入节点时抛出该异常。

示例

附加元素

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

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

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

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