動態創建 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>
div、span、input、select、option 等element.name = value,但適用於所有屬性(含自定義屬性)disabled、checked、selected)設置為空字串或屬性名即可生效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);
| 錯誤 | 正確做法 |
|---|---|
innerHTML += ... 循環拼接 | 用 DocumentFragment 或數組 join 後一次性 innerHTML |
| 創建後未掛載 | 必須 appendChild 到文檔樹中 |
setAttribute('class', 'x') 覆蓋原有 class | 用 classList.add('x') 或 el.className += ' x' |
| 在循環中頻繁操作 DOM | 批量操作用 Fragment,或虛擬 DOM 庫 |