浏览器与 Web API / 系统课时
append、prepend 与 appendChild
append、prepend 与 appendChild
向父节点加入内容时,三个 API 看似相近,却在插入位置、字符串处理、参数数量和返回值上有明确差异。本课通过一个可运行示例建立选择规则,并说明节点被重复插入时为何会“移动”。
学习目标
- 区分
append、prepend与appendChild的参数和返回值 - 验证元素节点、字符串和现有节点的实际插入行为
- 根据插入位置与后续代码需求选择合适 API
三个接口的核心差异
这三个方法都由父节点发起调用。prepend 把内容放到第一个子节点之前,append 和 appendChild 都放到最后一个子节点之后,但后两者支持的参数并不相同。
| 方法 | 插入位置 | 可接收内容 | 参数数量 | 返回值 |
|---|---|---|---|---|
prepend(...) |
子节点列表开头 | 节点或字符串 | 多个 | undefined |
append(...) |
子节点列表末尾 | 节点或字符串 | 多个 | undefined |
appendChild(node) |
子节点列表末尾 | 单个 Node |
一个 | 传入的节点对象 |
传给 append 或 prepend 的字符串会变成文本节点,不会按 HTML 解析。因此字符串 "<strong>重点</strong>" 会原样显示尖括号,而不是生成 strong 元素。appendChild 只接收节点,直接传字符串会抛出 TypeError。
主示例:同时验证顺序和返回值
下面代码可直接粘贴到浏览器控制台运行。它创建一个内容区,依次调用三个方法,再读取最终子节点顺序和返回值。
const list = document.createElement("section");
list.id = "course-panel";
const first = document.createElement("p");
first.textContent = "DOM 基础";
const second = document.createElement("p");
second.textContent = "节点创建";
const third = document.createElement("p");
third.textContent = "事件处理";
// append 和 prepend 可以一次接收多个节点或字符串。
const appendResult = list.append(first, "文本尾项");
const prependResult = list.prepend(second);
// appendChild 只插入一个节点,并返回该节点。
const childResult = list.appendChild(third);
document.body.replaceChildren(list);
const order = [...list.childNodes].map((node) =>
node.nodeType === Node.TEXT_NODE
? `文本:${node.textContent}`
: `元素:${node.textContent}`
);
console.log(order);
console.log(appendResult, prependResult, childResult === third);预期输出:
[
"元素:节点创建",
"元素:DOM 基础",
"文本:文本尾项",
"元素:事件处理"
]
undefined undefined true页面中会出现一个内容区,其中“节点创建”位于最前,“事件处理”位于最后;“文本尾项”是直接文本节点,不是 p 元素。
已存在的节点会被移动
DOM 中同一个节点不能同时占据两个位置。把已经挂载的节点再次传给任一方法时,浏览器会先从原位置移除它,再插入新位置,而不会自动复制。
因此,组件需要在多个位置显示相同结构时,应分别调用 cloneNode(true) 创建副本,或重新执行创建函数。不要把“再次 append”误认为复制,否则旧位置的内容会突然消失。
DocumentFragment 也可传给这些方法。插入后,片段中的子节点会进入目标父节点,片段自身变为空;这适合先在内存中组装一批节点,再一次挂载。
如何选择
需要插到开头时使用 prepend。需要一次追加多个节点或安全地追加纯文本时使用 append。只追加一个节点,并且后续代码需要直接取得该节点返回值时,使用 appendChild 更合适。
无论选择哪个方法,插入的是现有节点就会发生移动。若内容来自用户输入且只应作为文字显示,优先使用字符串参数或显式创建文本节点,不要转成 HTML 字符串解析。