jQuery 有個很一致但也容易混淆的設計:同一個方法名,有沒有帶參數決定它是「讀」還是「寫」。本文把最常打交道的幾個方法整理清楚。
$('#test').val(); // 取得值
$('#test').val('aa'); // 把值設為 aa
凡是能放進 form 裡的元素——input、textarea、select——都可以用 .val() 取得目前的值。這是最不需要思考的一組。
$('#msg').html(); // 取得 HTML 內容
$('#msg').html('<b>new content</b>'); // 寫入 HTML,頁面顯示粗體
$('#msg').text(); // 取得純文字
$('#msg').text('<b>new content</b>'); // 寫入純文字,頁面原樣顯示標籤
這兩個方法主要用在 div、span 這類容器元素上。.html() 取代了舊寫法 innerHTML,.html('test') 等同 innerHTML = 'test';.text() 則對應 innerText / textContent。
兩者的差異在「內容會不會被當成 HTML 解析」。只要內容可能含有使用者輸入,就該用 .text()——用 .html() 寫入未淨化的外部資料,等於把那段字串當成程式碼執行,是 XSS 的標準入口。
$('#test').attr('name'); // 取得 name 屬性
$('#test').attr('id', 'test2'); // 把 id 設為 test2
attr() 的讀寫判斷方式和上面一致:一個參數是讀,兩個參數是寫。它的特殊之處在於能操作任意屬性,而不像 val() 那樣綁定在 value 上。
但要注意一個關鍵界線:「屬性(attribute)」與「property」是兩回事。checked、selected、disabled 這些會隨使用者互動改變狀態的,都屬於 property,必須用 prop():
$("#chk").prop("checked"); // 目前是否勾選(正確)
$("#chk").attr("checked"); // HTML 上原本寫的值(可能過時)
$("#chk").prop("checked", true); // 設定勾選
而 href、src、title、class 這類不隨互動變化的,用 attr() 就對了。
$("#msg").height() / $("#msg").height("300");
$("#msg").width() / $("#msg").width("200");
$("#msg").css("background") / $("#msg").css("background", "#ccc");
$("#msg").click() / $("#msg").click(fn);
blur、focus、select、submit 等事件方法也都具備同樣的雙重身分——不帶參數時是「觸發」,帶函式時是「綁定」。
讀:只有方法名。
寫:方法名 + 值。
property 類屬性用 prop(),其餘用 attr()。
容器內容用 html()/text(),表單值用 val()。
不確定內容可信度時,一律選 text()。
把這五條記住,日常九成的取值設值場景都不用再查文件。