讀取與寫入元素內容是 jQuery 最日常的操作。html()、text()、val() 三個方法各有分工,用錯了會出現 HTML 被當成純文字、或值寫不進去的狀況。
html() 讀寫的是內部 HTML 原始碼,包含標籤本身。寫入時標籤會被解析成真正的元素。
text() 讀寫的是純文字。寫入時標籤符號會被跳脫,原封不動顯示為字元。
val() 針對表單元素,讀寫的是 value 屬性,對 select、checkbox、radio 也有特殊行為。
$(function () {
// 取得 p 元素的 HTML 原始碼
$("input:eq(0)").click(function () {
alert($("p").html());
});
// 取得 p 元素的純文字
$("input:eq(1)").click(function () {
alert($("p").text());
});
// 設定 HTML(strong 會真的變粗體)
$("input:eq(2)").click(function () {
$("p").html("<strong>你最喜歡的水果是?</strong>");
});
// 設定純文字(strong 會原樣顯示出來)
$("input:eq(3)").click(function () {
$("p").text("<strong>你最喜歡的水果是?</strong>");
});
// 取得按鈕的 value
$("input:eq(5)").click(function () {
alert($(this).val());
});
// 設定按鈕的 value
$("input:eq(6)").click(function () {
$(this).val("我被點擊了!");
});
});
注意 html() 與 text() 帶參數寫入時的差別:前者把字串當 HTML 解析,後者當純文字。凡是內容來自使用者輸入,一律該用 text(),否則就是 XSS 漏洞。
把提示文字直接寫死在 value 裡,比對硬編碼的字串更可靠:
$("#address").focus(function () {
var v = $(this).val();
if (v == this.defaultValue) $(this).val(""); // 焦點移入就清空
});
$("#address").blur(function () {
var v = $(this).val();
if (v == "") $(this).val(this.defaultValue); // 離開時若空白就還原
});
$("#password").focus(function () {
if ($(this).val() == this.defaultValue) $(this).val("");
});
$("#password").blur(function () {
if ($(this).val() == "") $(this).val(this.defaultValue);
});
this.defaultValue 是原生 DOM 屬性,代表該元素在 HTML 中的初始值,永遠不會被使用者操作改動,因此拿來比對特別合適。
// 單選下拉選單
$("#single").val("2");
// 多選下拉選單
$("#multiple").val(["選擇2號", "選擇3號"]);
// 核取方塊與單選鈕
$(":checkbox").val(["check2", "check3"]);
$(":radio").val(["radio2"]);
另一種更明確的寫法是直接操作屬性:
// 下拉選單
$("#single option").removeAttr("selected");
$("#single option:eq(1)").attr("selected", true);
// 核取方塊
$(":checkbox").removeAttr("checked");
$(':checkbox[value=check2]').attr("checked", true);
$('[value=radio2]:radio').attr("checked", true);
從 jQuery 1.6 開始,checked 與 selected 這類「目前狀態」應該用 prop(),attr() 讀到的是 HTML 中的初始屬性而非即時狀態。1.9 之後 attr 的行為又更嚴格。跨版本專案上最安全的寫法其實是原生 DOM:
$(":checkbox[name=" + name + "]").each(function () {
this.checked = someBoolean; // 任何版本都適用
});
而 :checkbox 這種寫法只是「屬性 type 為 checkbox」的語法糖,效能不如 $('input[type=checkbox]'),元素多時差距明顯。