核心 API 對比
| 方法 | 插入內容類型 | 解析 HTML | 效能 | 支援度 |
insertAdjacentHTML | HTML 字串 | ✅ 是 | 高 | IE8+、全現代瀏覽器 |
insertAdjacentText | 純文字 | ❌ 否(自動跳脫) | 最高 | IE8+、全現代瀏覽器 |
innerHTML | HTML 字串 | ✅ 是 | 中(重繪整個容器) | 全瀏覽器 |
appendChild | DOM 節點 | N/A | 高 | 全瀏覽器 |
四個插入位置詳解
<div id="container">
<!-- beforebegin -->
<div>
<!-- afterbegin -->
現有內容
<!-- beforeend -->
</div>
<!-- afterend -->
</div>
insertAdjacentHTML 完整範例
var container = document.getElementById('container');
// 1. beforeBegin:容器之前(同層級前方)
container.insertAdjacentHTML('beforebegin', '<p>前置標題</p>');
// 2. afterBegin:容器內部第一個子節點前
container.insertAdjacentHTML('afterbegin', '<span class="badge">NEW</span>');
// 3. beforeEnd:容器內部最後一個子節點後(最常用,等同 append)
container.insertAdjacentHTML('beforeend', '<li>新列表項</li>');
// 4. afterEnd:容器之後(同層級後方)
container.insertAdjacentHTML('afterend', '<hr><footer>頁尾</footer>');
實戰場景:動態表單欄位新增
function addFileInput() {
var html = '<div class="file-row">'
+ '<input type="file" name="files[]" accept="image/*">'
+ '<button type="button" class="remove-btn">移除</button>'
+ '</div>';
// 插入到容器末尾,不影響現有欄位
document.getElementById('fileList').insertAdjacentHTML('beforeend', html);
}
// 事件委派處理動態新增的移除按鈕
document.getElementById('fileList').addEventListener('click', function(e) {
if (e.target.matches('.remove-btn')) {
e.target.closest('.file-row').remove();
}
});
insertAdjacentText 安全插入純文字
var msg = '<script>alert("XSS")</script> 用戶輸入';
// innerHTML 會執行腳本(危險!)
// container.innerHTML += msg;
// insertAdjacentText 自動跳脫,安全顯示原文
container.insertAdjacentText('beforeend', msg);
// 畫面顯示: 用戶輸入
插入