document.createElement 是動態建立 DOM 元素的標準方法。本文詳細比較兩種主要寫法:標準屬性設定法與 HTML 字串直傳法,並示範建立按鈕、連結、Label 等常見元素的完整範例。
建立元素後,逐一設定屬性、事件綁定,最後 appendChild 加入文檔。語意清晰、除錯容易、符合 DOM 標準。
function createButton1() {
var btn = document.createElement("input");
btn.type = "button";
btn.value = "我是動態建立的1";
btn.onclick = function() { alert(this.value); };
document.body.appendChild(btn);
}
將完整 HTML 字串傳給 createElement,瀏覽器會嘗試解析。注意:此行為非標準,各瀏覽器解析行為可能不一致,不建議生產環境使用。
function createButton2() {
// 非標準寫法:傳入完整 HTML 字串
var btn = document.createElement(
"<input type='button' value='我是動態建立的2' onclick='OnClick2(this)' />"
);
document.body.appendChild(btn);
}
function OnClick2(btn) {
alert(btn.value);
}
使用字串法建立 <a> 時,內文不會自動顯示,必須額外設定 innerText 或 innerHTML。
function createLink() {
var link = document.createElement("<a href='https://www.baidu.com'>百度</a>");
// 必須手動設定內文
link.innerText = "百度";
document.body.appendChild(link);
}
function createLabel() {
var lbl = document.createElement("label");
lbl.setAttribute("for", "userName"); // 標準屬性
lbl.setAttribute("myAge", "12"); // 自訂屬性
lbl.innerText = "用戶名:";
document.body.appendChild(lbl);
}
<body>
<input type="button" value="動態建立按鈕1" onclick="createButton1()" />
<input type="button" value="動態建立按鈕2" onclick="createButton2()" />
<input type="button" value="動態建立連結" onclick="createLink()" />
<input type="button" value="動態建立Label" onclick="createLabel()" />
<input type="text" id="userName" value="李莫" />
</body>
ES6 可搭配 Object.assign 或展開運算子簡化屬性設定:
function createBtnModern(text, onClick) {
const btn = document.createElement('button');
Object.assign(btn, {
type: 'button',
textContent: text,
className: 'btn btn-primary',
onclick: onClick
});
return btn;
}
// 使用
document.body.appendChild(
createBtnModern('現代寫法按鈕', () => alert('ES6 風格'))
);
| 維度 | 標準屬性法 | HTML 字串法 |
|---|---|---|
| 標準相容性 | ✅ 所有瀏覽器 | ⚠️ 非標準,行為差異 |
| 程式碼可讀性 | ✅ 清晰、易維護 | ❌ 字串雜亂、難除錯 |
| XSS 風險 | ✅ 低(屬性分離) | ⚠️ 高(若字串含用戶輸入) |
| 效能 | 略慢(多次屬性存取) | 略快(單次解析) |
| 建議 | 生產環境首選 | 僅限快速原型/測試 |