在 jQuery 裡,「往頁面上加東西」其實只需要判斷兩件事:新內容要放進目標元素的內部還是外部;以及這句語法的主語是目標元素,還是新產生的節點。把這兩點想通,append、prepend、before、after、appendTo、prependTo 一整組方法就不會再記混。
先記住這組對照:
準備一段最簡單的結構:
<div id="content"> <p>在我的後面追加一條新聞</p> </div>
用 append() 把新段落塞進 #content 內部,成為它最後一個子節點:
<script type="text/javascript">
jQuery(function () {
// 在元素內部追加內容
$("#content").append("<p>姚明退役了...</p>");
});
</script>
如果你希望新段落在 #content 外面、緊接著它之後出現,就要改用 after(),此時兩者是平級的兄弟關係,而不是父子關係:
<script type="text/javascript">
jQuery(function () {
// 作為兄弟元素追加到 #content 後面
$("#content").after("<p>姚明退役了...</p>");
});
</script>
上面那些方法的共同點是「由容器出發去找內容」。jQuery 另外提供一組把語序反過來寫的方法,主語變成「要被搬過去的那個元素」。
HTML:
<div id="content1" style="border:1px solid red"> <p>窗前明月光</p> </div> <span>疑是地上霜</span>
把 span 搬進 #content1 的最後面:
<script type="text/javascript">
jQuery(function () {
// 將 span 追加到 #content1 內部末尾
$("span").appendTo("#content1");
});
</script>
對應關係很單純:$("A").appendTo("#B") 等同於 $("#B").append("A");prependTo 與 prepend 也是同樣的一對。哪一種讀起來順,就用哪一種。
prepend() 的行為與 append() 相反,它把內容放到容器的第一個位置。
<div>
<div id="content">
<p>在我的後面追加一條新聞</p>
</div>
</div>
<script type="text/javascript">
jQuery(function () {
// 在元素的開始位置追加內容
$("#content").prepend("<p>頭部</p>");
});
</script>
<div id="content"> <p>在我的後面追加一條新聞</p> </div> <span>疑是地上霜</span>
<script type="text/javascript">
jQuery(function () {
// 由 span 出發,插入到 #content 的開頭
$("span").prependTo("#content");
});
</script>
這裡要注意一個常見誤寫。如果目標是「把 span 放到 #content 前面」,正確寫法應該是以容器為主語:
<script type="text/javascript">
jQuery(function () {
// 讓 span 成為 #content 的前一個兄弟元素
$("#content").before($("span"));
// 等價寫法:$("span").insertBefore("#content");
});
</script>
直接寫 $("span").before("#content") 是把字串 "#content" 當成 HTML 片段插入,並不會選到元素,這是初學者最容易踩的坑。
wrap(html) 會為選集合中的每一個元素各自套上一層外殼。傳入的 HTML 片段必須是單一、結構完整的標籤,不能夾帶兄弟節點或純文字,否則行為會不如預期。
<form id="form1" runat="server"> <span>將我包含在 b 中</span> </form>
<script type="text/javascript">
jQuery(function () {
$("span").wrap("<b></b>");
});
</script>
執行後每個 span 都會被各自的 b 標籤包住,也就是說,三個 span 會產生三個 b。
如果你想要的是「把一整批元素塞進同一個容器」,那就用 wrapAll(),它只會產生一個外層。
<form id="form1" runat="server"> <p>p 內容</p> <p>p 內容</p> <p>p 內容</p> <p>p 內容</p> <p>p 內容</p> </form>
<script type="text/javascript">
jQuery(function () {
$("p").wrapAll("<div style='border:1px solid red'></div>");
});
</script>
wrap 與 wrapAll 的差異就在這裡:前者「各自穿衣」,後者「一起進同一個房間」。選擇哪一個,取決於你的樣式與互動需求。
wrapInner() 的包裹範圍不是元素本身,而是元素內部的所有子內容,外殼套在裡頭。
<p>將 p 標籤的文字用 b 標籤包含起來</p> <p>也將 p 標籤的文字用 b 標籤包含起來</p>
<script type="text/javascript">
jQuery(function () {
$("p").wrapInner("<b></b>");
});
</script>
插入類方法記這三條線就夠:append/prepend 管內部、before/after 管外部、appendTo/prependTo/insertBefore/insertAfter 只是把主客語對調。包裹類方法則看範圍:wrap 各自包、wrapAll 一起包、wrapInner 往裡包。