jQuery 的一大特色是「同一個方法,帶參數就是設定,不帶參數就是取得」。把這組對照記熟,日常開發幾乎不用查文件。
$("#msg").html(); // 回傳 id 為 msg 的元素節點的 HTML 內容
$("#msg").html("new content"); // 把 "new content" 作為 HTML 字串寫入,
// 頁面會顯示粗體的 new content
$("#msg").text(); // 回傳 id 為 msg 的元素節點的文字內容
$("#msg").text("new content"); // 把 "new content" 作為純文字寫入,
// 頁面只顯示 new content
兩者的差別在於:若內容中含有 HTML 標籤,html() 會把它解析成標籤,text() 則會原樣當成文字顯示。凡是處理使用者輸入或外部資料,請優先使用 text(),以避免 XSS 風險。
$("#msg").height(); // 回傳 id 為 msg 的元素高度
$("#msg").height("300"); // 把 id 為 msg 的元素高度設為 300
$("#msg").width(); // 回傳 id 為 msg 的元素寬度
$("#msg").width("300"); // 把 id 為 msg 的元素寬度設為 300
$("input").val(); // 回傳表單輸入框的 value 值
$("input").val("test"); // 把表單輸入框的 value 設為 test
val() 也能用來取得下拉選單的選取值,或一次設定多個 checkbox/radio 的勾選狀態,寫起來比手動遍歷乾淨很多。
$("#msg").click(); // 觸發 id 為 msg 的元素單擊事件
$("#msg").click(fn); // 為 id 為 msg 的元素單擊事件加上處理函式
同樣的雙重身分也出現在 blur、focus、select、submit 等事件上,用法完全一致。