浏览器与 Web API / 系统课时

使用 createElement 创建元素

使用 createElement 创建元素

本课解决“如何用 JavaScript 从零创建一个可插入页面的元素”这个问题。你将完成元素创建、内容与属性设置、插入页面和结果验证,并理解新节点在插入前为什么不会出现在文档中。

学习目标

  • 掌握 document.createElement() 的基本用法
  • 能为新元素设置文本、类名和自定义属性
  • 能判断元素创建后是否已经进入文档

创建元素并设置数据

document.createElement(tagName) 会创建一个指定标签名的 Element 对象。参数只写标签名,不写尖括号,例如创建按钮应传入 "button",而不是 "<button>"。后者包含非法字符,浏览器会抛出 InvalidCharacterError。

调用完成后,元素已经存在于内存中,可以读取和修改,但它还没有父节点,也不会显示在页面上。此时 element.parentElement 为 null,element.isConnected 为 false。

创建元素后,通常使用 textContent 写入纯文本,使用 className 或 classList 设置样式类,使用普通属性设置 id、title、disabled 等状态,并通过 dataset 设置 data-* 自定义数据。

需要创建普通文本时,优先使用 textContent。只有确实需要解析可信 HTML 片段时才考虑 innerHTML,否则容易引入结构错误或安全风险。

完整示例:创建并插入按钮

下面的页面在点击“创建按钮”后生成一个新的课程按钮,并把它插入结果区域。示例同时输出插入前后的连接状态。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>createElement 示例</title>
</head>
<body>
  <button id="create">创建按钮</button>
  <div id="result"></div>

  <script>
    const createButton = document.querySelector("#create");
    const result = document.querySelector("#result");

    createButton.addEventListener("click", () => {
      const courseButton = document.createElement("button");

      // 节点此时只存在于内存中,尚未进入文档
      console.log("插入前:", courseButton.isConnected);

      courseButton.textContent = "开始学习 DOM";
      courseButton.className = "course-button";
      courseButton.id = "start-dom";
      courseButton.dataset.course = "html-dom";
      courseButton.title = "进入 HTML DOM 编程课程";

      result.append(courseButton);

      // append 完成后,节点才与当前文档连接
      console.log("插入后:", courseButton.isConnected);
    });
  </script>
</body>
</html>

预期结果

text
首次点击后,页面结果区域出现“开始学习 DOM”按钮。
控制台依次输出:
插入前: false
插入后: true

实际浏览器控制台可能把标签和值显示在同一行,但布尔值应与上述结果一致。

插入规则与常见错误

创建节点和插入节点是两个独立动作。createElement() 只负责生成对象,append()、prepend()、before()、after() 或 replaceWith() 才负责把节点放入某个位置。

一个节点同一时间只能处于一个父节点下。如果把已经插入页面的元素再次追加到另一个容器,浏览器会移动它,而不是复制它。需要副本时,应重新创建元素或使用 cloneNode()。

连续点击示例中的按钮会创建多个新元素,因为事件处理函数每次都会再次调用 createElement()。如果业务只允许一个按钮,应先查询现有节点,或在创建后禁用触发按钮。

若控制台能打印元素但页面没有变化,应检查是否调用了插入方法、目标父元素是否查询成功,以及脚本执行时目标容器是否已经存在。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 createElement 创建元素

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

登录哪都通