需求:將 AJAX 獲取的 HTML 字符串插入頁面,且其中可能包含 <script> 需執行。直接 innerHTML 會導致腳本不執行;$.html() 雖執行腳本但可能導致閃爍、樣式衝突。本文介紹經典 隱藏 iframe 解析法 及現代 DOMParser/template 替代方案。
/**
* 將 HTML 字符串轉為 DOM 元素,內部 script 會自動執行
* @param {string} html - 完整 HTML 片段
* @returns {Element|null} 首層子元素
*/
function str2DOMElement(html) {
var frame = document.createElement('iframe');
frame.style.display = 'none';
document.body.appendChild(frame);
var doc = frame.contentDocument || frame.contentWindow.document;
doc.open();
doc.write(html);
doc.close();
var el = doc.body.firstElementChild; // 取首個元素節點
document.body.removeChild(frame);
return el;
}
// 使用
var markup = '<div><p>動態內容</p><script>console.log("腳本執行了")</script></div>';
var el = str2DOMElement(markup);
document.getElementById('container').appendChild(el);
原理:iframe 擁有獨立文檔上下文,document.write 會完整解析 HTML 並執行腳本。取得所需元素後移除 iframe,不留痕跡。
缺點:創建/銷毀 iframe 有微小性能開銷;跨域受限(同源策略);部分瀏覽器需 frame.contentWindow.document 兼容。
function parseHTML(html) {
var parser = new DOMParser();
var doc = parser.parseFromString(html, 'text/html');
// doc.body 內包含解析後的節點,script 標籤會被標記為 "不執行"
// 若需執行腳本,需手動遍歷執行(見下文)
return doc.body.firstElementChild;
}
注意:DOMParser 解析出的 <script> 不會自動執行(安全機制)。若需執行,需手動處理:
function parseAndExecute(html) {
var parser = new DOMParser();
var doc = parser.parseFromString(html, 'text/html');
var scripts = doc.querySelectorAll('script');
scripts.forEach(function (oldScript) {
var newScript = document.createElement('script');
if (oldScript.src) newScript.src = oldScript.src;
else newScript.textContent = oldScript.textContent;
document.head.appendChild(newScript).parentNode.removeChild(newScript);
});
return doc.body.firstElementChild;
}
var tpl = document.createElement('template');
tpl.innerHTML = html; // script 不執行,僅構建 DOM 樹
var clone = document.importNode(tpl.content, true);
container.appendChild(clone);
| 方案 | 腳本執行 | 性能 | 兼容性 | 適用場景 |
|---|---|---|---|---|
| 隱藏 iframe | 自動執行 | 中(創建 iframe 開銷) | IE9+ | 需執行腳本、舊專案兼容 |
| DOMParser + 手動執行 | 可控執行 | 高(原生解析器) | IE10+ | 現代專案、需安全控制腳本執行 |
| <template> | 不執行 | 極高 | IE13+ (Edge) | 純結構模板、無腳本、高頻渲染 |
| jQuery $.parseHTML() | 可選執行 | 中 | 全兼容 | jQuery 專案、簡化代碼 |
DOMParser + 手動腳本執行(可控、安全)。選對方案,實現無閃爍、安全、高效的動態內容更新。