after() 的作用是在選取元素的後面插入內容。它接受的字串參數除了寫死 HTML 之外,還可以傳入一個函式,讓每個目標元素插入的內容各不相同。
點擊按鈕,在每個 p 元素後面各插入一段相同的內容。
$("button").click(function(){
$("p").after("<p>Hello world!</p>");
});
$("button").click(function(){
$("p").after(function(n){
return "<p>The p element above has index " + n + "</p>";
});
});
函式中的參數 n 是該元素在選取集合中的索引(從 0 開始),this 則指向該元素本身,因此可以用 $(this) 讀取它的屬性或內容來決定要插入什麼。
注意:傳入的函式必須回傳一個 HTML 字串。若沒有回傳值,就不會插入任何內容。
after():插入到選取元素的後面(外部、同層)before():插入到選取元素的前面(外部、同層)append():插入到選取元素內容的結尾(內部)prepend():插入到選取元素內容的開頭(內部)另外,這四個方法都有對應的「反向版本」:insertAfter()、insertBefore()、appendTo()、prependTo()。差別在於主詞與受詞互換,例如 $("<p>Hi</p>").appendTo("div") 與 $("div").append("<p>Hi</p>") 結果相同,但前者在串接多個操作時可讀性更好。
若函式回傳的內容含有使用者輸入,直接插入 HTML 會造成 XSS 風險。這類情境應改用 .after(document.createTextNode(text)) 建立文字節點,或先經過轉義處理再插入。