DIV CSS 佈局教程網

jQuery append() 與 html() 的差別:附加還是取代?
編輯:JQuery特效代碼     

這兩個方法都能改寫元素內容,但行為截然不同。混用會導致「內容莫名消失」或「重複疊加」的問題,值得花一分鐘分清楚。

一句話區別

  • append(content):在選中元素的內部結尾插入內容,原有內容保留。
  • html(content):取代選中元素的所有內部內容(等同 innerHTML 賦值)。

從字面上也能記住:append 是「附加」,html() 帶參數時是「重設」。

append() 的用法

$(selector).append(content)

支援傳入函式,依每個元素的目前內容動態決定要附加什麼:

$(selector).append(function (index, html) {
    return "<span>第 " + (index + 1) + " 項</span>";
});

參數 index 是元素在集合中的序號,html 是該元素目前的內部 HTML。這個形式在批次加入序號或索引時很省事。

<script src="/jquery.min.js" type="text/javascript"></script>
<style>
.imgFocus { border: 1px solid #eee; }
</style>

<p></p>

<script type="text/javascript">
var showimg = "<div class='imgFocus'>123456</div>";
$("p").append(showimg);
</script>

html() 的用法

不帶參數時是讀取,回傳第一個匹配元素的內部 HTML:

$(selector).html()

帶參數時是設定,取代所有匹配元素的內容:

$(".btn1").click(function () {
    $("p").html("Hello <b>world</b>!");
});

實戰:清空訊息區 vs 附加錯誤訊息

$("a[href$='logout.asp']").click(function (event) {
    event.preventDefault();

    $.get("/xxlr/Logout.asp", "", function (data, textStatus) {
        if (data == 1) {
            // 登出成功:清空訊息區
            $('#message').html("");
            $("#userlogin>div").show();
        } else {
            // 登出失敗:附加錯誤訊息
            $('#message').append("<p><strong>登錄失敗,請重新嘗試!</strong></p>");
        }
    });
});

這段剛好示範了兩者的正確分工:要清掉舊內容用 html(""),要追加一筆新訊息用 append()。若反過來用 html(錯誤訊息),會把先前的提示都蓋掉;若用 append(""),則什麼都不會發生。

append 家族與相關方法

jQuery 在插入位置上提供了一整組方法,選對適合你資料流方向的:

  • append() / appendTo():加到自己的內容尾端 / 把自己加到目標的尾端。
  • prepend() / prependTo():加到內容頭部。
  • after() / before():插到外面,成為兄弟節點。
  • wrap() / unwrap():外包一層 / 拆掉外層。

append() 與 appendTo() 效果相同,差別只在語句主詞——A.append(B) 等價於 B.appendTo(A)。選擇哪個純屬可讀性考量。

一個效能提醒

在迴圈中反覆呼叫 append() 會造成多次 DOM 操作與重排。大量插入時,建議先組好整段 HTML 字串再一次寫入,或先把元素附加到文件片段(DocumentFragment)再掛上頁面:

var html = "";
for (var i = 0; i < 500; i++) {
    html += "<li>項目 " + i + "</li>";
}
$("ul").html(html);        // 一次寫入,遠快於 500 次 append

最後提醒:用 html() 或 append() 插入含使用者輸入的內容時,務必先做 HTML 編碼,否則等於為 XSS 開門。純文字情境請改用 .text(),它會自動處理轉義。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved