萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 獲取內容與屬性:text()、html()、val()、attr() 完整用法對比

jQuery 提供四大核心方法存取元素內容與屬性,語意不同、回傳值不同、適用場景不同。搞清差異能避免「取不到值」「拿到帶標籤字串」等常見錯誤。

方法對比總表

方法用途回傳值可鏈式設值典型場景
.text()純文字內容字串(含後代文字,無標籤)✅讀取/設定純文字,自動轉義 HTML
.html()HTML 內容字串(含標籤)✅讀取/替換內部 HTML 結構
.val()表單控制項值字串/陣列(多選)✅input/select/textarea 取值、設值
.attr(name)HTML 屬性字串 / undefined✅讀取/設定 id、src、href、data-* 等屬性
.prop(name)DOM 屬性布林/字串/物件✅checked、disabled、selected、value(最新值)
.data(key)data-* 快取任意型別(自動轉型)✅讀寫 data-*,內部快取不同步回 DOM

關鍵差異範例

<div id="box">Hello <span>World</span></div>
<input id="chk" type="checkbox" checked>

$('#box').text();   // "Hello World"
$('#box').html();   // "Hello World"

$('#chk').attr('checked'); // "checked" (初始屬性)
$('#chk').prop('checked'); // true (當前狀態)
$('#chk').is(':checked');  // true (推薦判斷方式)

常見坑點

  • `.val()` 只對表單元素生效,對 `
    ` 等回傳 `undefined`。
  • `.attr()` vs `.prop()`:布林屬性(checked, disabled, selected, readonly)必須用 `.prop()` 取得即時狀態;`.attr()` 回傳初始 HTML 屬性值。
  • `.data()` 快取機制:首次讀取將 `data-*` 解析並快取,後續修改 DOM `data-*` 不會反映在 `.data()`,反之亦然。需同步請用 `.attr('data-x', val)`。
  • 多選 `