append(content) 的功能是把內容附加到每個符合元素的最內部。多數情況它 behave 得很好,但一旦傳入的 HTML 片段不完整,結果可能出乎意料。
<p>I would like to say: </p>
$("p").append("<b>Hello</b>");
// 結果:
// [ <p>I would like to say: <b>Hello</b></p> ]
標籤閉合完整,瀏覽器照著解析,一切正常。
$("p").append("<b>");
$("p").append("Hello</b>");
// 結果:
// [ <p>I would like to say: <b></b>Hello</p> ]
原本我們期待的是 <b>Hello</b>,實際卻變成一個空的 <b></b> 加上游離的「Hello」。
關鍵在於HTML 解析器不允許「未閉合的標籤」跨越多個節點存在。當你呼叫 append("<b>") 時,瀏覽器必須把這段片段解析成一個完整的 DOM 子樹,於是它自動補上 </b>,產生一個空元素。第二次追加的 "Hello</b>" 裡,那個多餘的閉合標籤會被忽略,「Hello」就變成純文字節點。
換句話說,append() 不是「往字串尾巴接字」,而是「把傳入的內容解析成節點後插入」。每一次呼叫都是一次獨立且完整的解析,兩次呼叫之間不會有任何標籤狀態被保留。
// 一次傳入完整片段
$("p").append("<b>Hello</b>");
// 或建立元素後再設定內容
$("<b>").text("Hello").appendTo("p");
// 若內容來自外部資料,用 text() 更安全
$("p").append(document.createTextNode(userInput));
appendTo() 與 append() 效果相同,只是主詞與受詞順序相反,讀起來更接近自然語句。prepend() 是插到最前面,同樣有「片段必須完整」的限制。after()/before() 是插到同層,也不接受跨節點的破碎標籤。append(),比迴圈中反覆呼叫效能好得多,因為只觸發一次 DOM 插入與重排。最後提醒:任何來自使用者或後端的內容,用 html()/append(HTML字串) 插入前都應該先做消毒,否則容易形成 XSS 漏洞。