萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 動態創建 DOM 元素完整指南:createElement、appendChild、setAttribute 實戰

動態創建 DOM 節點是前端開發核心技能。本文通過一個「按數量批量創建輸入框」的完整示例,詳細講解 document.createElement、appendChild、setAttribute 等核心 API 的用法與最佳實踐。

完整可運行示例

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>動態創建 DOM 元素示例</title>
</head>
<body>
  <input type="text" id="itemsNumber" placeholder="輸入數量" />
  <input type="button" id="btn" value="創建輸入框" onclick="addItems()" />
  <div id="div1"></div>

  <script>
  function addItems() {
    // 1. 獲取容器並清空
    var container = document.getElementById("div1");
    container.innerHTML = ""; // 簡單清空,或用 while(container.firstChild) container.removeChild(container.firstChild)
    
    // 2. 獲取用戶輸入數量
    var count = parseInt(document.getElementById('itemsNumber').value, 10);
    if (isNaN(count) || count <= 0) return;
    
    // 3. 批量創建元素(使用 DocumentFragment 優化性能)
    var fragment = document.createDocumentFragment();
    
    for (var i = 0; i < count; i++) {
      // 創建 input 元素
      var input = document.createElement("input");
      input.setAttribute("type", "text");
      input.setAttribute("placeholder", "輸入框 " + (i + 1));
      
      // 創建換行元素
      var br = document.createElement("br");
      
      // 添加到文檔片段
      fragment.appendChild(input);
      fragment.appendChild(br);
    }
    
    // 4. 一次性掛載到 DOM(觸發一次重排)
    container.appendChild(fragment);
  }
  </script>
</body>
</html>

核心 API 詳解

1. document.createElement(tagName)

  • 創建指定標籤名的元素節點
  • 返回新元素,尚未掛載到文檔樹
  • 支援所有標準 HTML 標籤:div、span、input、select、option 等

2. element.setAttribute(name, value)

  • 設置元素屬性(HTML Attribute)
  • 等同於 element.name = value,但適用於所有屬性(含自定義屬性)
  • 布爾屬性(如 disabled、checked、selected)設置為空字串或屬性名即可生效

3. parent.appendChild(child)

  • 將子節點添加到父節點的子節點列表末尾
  • 若子節點已在文檔中,會先移動再添加(不會複製)
  • 返回添加的子節點

4. DocumentFragment:批量操作性能優化

var fragment = document.createDocumentFragment();
fragment.appendChild(child1);
fragment.appendChild(child2);
// ...
container.appendChild(fragment); // 只觸發一次重排重繪

原理:DocumentFragment 不在文檔樹中,操作不觸發重排。掛載時其子節點被移動到目標父節點,Fragment 本身為空。

進階:創建帶事件監聽的元素

function createButton(text, onClick) {
  var btn = document.createElement('button');
  btn.textContent = text; // 設置文本內容(比 innerHTML 更安全)
  btn.addEventListener('click', onClick);
  return btn;
}

// 使用
var btn = createButton('點擊我', function() {
  alert('按鈕被點擊!');
});
document.body.appendChild(btn);

現代語法糖:輔助函數封裝

// 創建元素的通用工廠函數
function h(tag, attrs, ...children) {
  const el = document.createElement(tag);
  if (attrs) {
    Object.entries(attrs).forEach(([key, value]) => {
      if (key === 'style' && typeof value === 'object') {
        Object.assign(el.style, value);
      } else if (key.startsWith('on') && typeof value === 'function') {
        el.addEventListener(key.slice(2).toLowerCase(), value);
      } else {
        el.setAttribute(key, value);
      }
    });
  }
  children.flat().forEach(child => {
    el.appendChild(child.nodeType ? child : document.createTextNode(String(child)));
  });
  return el;
}

// 使用示例:聲明式創建複雜結構
const form = h('form', { class: 'login-form', onsubmit: e => e.preventDefault() }, [
  h('h2', {}, '登錄'),
  h('input', { type: 'text', placeholder: '用戶名', required: true }),
  h('input', { type: 'password', placeholder: '密碼', required: true }),
  h('button', { type: 'submit' }, '提交')
]);
document.body.appendChild(form);

常見錯誤與避坑

總結

掌握 createElement、setAttribute、appendChild 三大核心 API,配合 DocumentFragment 批量優化,是原生 DOM 操作的基礎。現代開發中推薦使用聲明式工廠函數或框架(React/Vue/Svelte)抽象底層操作。

copyright © 萬盛學電腦網 all rights reserved
錯誤正確做法
innerHTML += ... 循環拼接用 DocumentFragment 或數組 join 後一次性 innerHTML
創建後未掛載必須 appendChild 到文檔樹中
setAttribute('class', 'x') 覆蓋原有 class用 classList.add('x') 或 el.className += ' x'
在循環中頻繁操作 DOM批量操作用 Fragment,或虛擬 DOM 庫