浏览器与 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。

主示例:同时验证顺序和返回值

下面代码可直接粘贴到浏览器控制台运行。它创建一个内容区,依次调用三个方法,再读取最终子节点顺序和返回值。

js
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);

预期输出:

text
[
  "元素:节点创建",
  "元素:DOM 基础",
  "文本:文本尾项",
  "元素:事件处理"
]
undefined undefined true

页面中会出现一个内容区,其中“节点创建”位于最前,“事件处理”位于最后;“文本尾项”是直接文本节点,不是 p 元素。

已存在的节点会被移动

DOM 中同一个节点不能同时占据两个位置。把已经挂载的节点再次传给任一方法时,浏览器会先从原位置移除它,再插入新位置,而不会自动复制。

因此,组件需要在多个位置显示相同结构时,应分别调用 cloneNode(true) 创建副本,或重新执行创建函数。不要把“再次 append”误认为复制,否则旧位置的内容会突然消失。

DocumentFragment 也可传给这些方法。插入后,片段中的子节点会进入目标父节点,片段自身变为空;这适合先在内存中组装一批节点,再一次挂载。

如何选择

需要插到开头时使用 prepend。需要一次追加多个节点或安全地追加纯文本时使用 append。只追加一个节点,并且后续代码需要直接取得该节点返回值时,使用 appendChild 更合适。

无论选择哪个方法,插入的是现有节点就会发生移动。若内容来自用户输入且只应作为文字显示,优先使用字符串参数或显式创建文本节点,不要转成 HTML 字符串解析。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

append、prepend 与 appendChild

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通