萬盛學電腦網

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

jQuery 取得元素內容與屬性完整指南:text()、html()、val()、attr() 實戰詳解

核心方法速查表

方法用途回傳值可否設定
.text() 取得/設定純文字內容(含子孫元素文字,移除 HTML 標籤) 字串 ✅
.html() 取得/設定HTML 內容(保留標籤) 字串 ✅
.val() 取得/設定表單元素值(input、select、textarea) 字串/陣列 ✅
.attr(name) 取得/設定HTML 屬性(src、href、id、data-* 等) 字串/null ✅
.prop(name) 取得/設定DOM 屬性(checked、disabled、selected、value) 布林/字串 ✅

實戰範例

1. 取得連結 href

<a id="site" href="https://example.com" title="範例">範例網站</a>
<button id="getHref">取得 href</button>

<script>
$('#getHref').click(() => {
  alert($('#site').attr('href')); // "https://example.com"
  // 也可取得 data-* 屬性
  // $('#site').attr('data-id');
});
</script>

2. 表單值處理

<input id="username" type="text" value="Alice">
<select id="role">
  <option value="admin">管理員</option>
  <option value="user" selected>一般用戶</option>
</select>
<textarea id="bio">Hello</textarea>

<script>
console.log($('#username').val()); // "Alice"
console.log($('#role').val());     // "user"
console.log($('#bio').val());      // "Hello"

// 設定值
$('#username').val('Bob');
$('#role').val('admin');
$('#bio').val('New bio');
</script>

3. 內容操作差異示範

<div id="box"><strong>粗體</strong> 文字</div>

<script>
console.log($('#box').text()); // "粗體 文字"
console.log($('#box').html()); // "粗體 文字"

$('#box').text('<em>新內容</em>'); // 顯示字面 "新內容"
$('#box').html('<em>新內容</em>'); // 渲染為斜體
</script>

進階技巧

批次設定屬性

$('#img').attr({
  src: 'photo.jpg',
  alt: '風景照',
  title: '點擊放大',
  'data-id': 123
});

移除屬性

$('#link').removeAttr('target'); // 移除 target="_blank"
$('#input').removeAttr('disabled'); // 啟用輸入框

.data() vs .attr('data-*')

<div id="el" data-user-id="42" data-role="admin"></div>

$('#el').data('userId');      // 42 (Number,自動型別轉換)
$('#el').attr('data-user-id'); // "42" (String,原始屬性值)
$('#el').data('role', 'editor'); // 只更新 jQuery 內部快取,不改 DOM 屬性
$('#el').attr('data-role', 'editor'); // 真正修改 DOM 屬性

常見誤區

  1. 用 .attr('checked') 判斷核取方塊:
    jQuery 1.6+ 應用 .prop('checked')(布林值),.attr 回傳 "checked"/undefined。
  2. .val() 對多選下拉選單回傳陣列:$('#multi').val() → ['a','b']。
  3. .html() 設定腳本標籤不會執行:jQuery 會移除 <script> 後再插入,若需執行請用 .append() 或 eval。

效能提示

  • 頻繁讀寫同一元素時,快取 jQuery 物件:const $el = $('#id'); $el.text(...); $el.val(...);。
  • 大量 DOM 操作時,考慮 DocumentFragment 或原生 textContent/innerHTML。

熟練掌握這四大核心方法,即可輕鬆應付 90% 的 DOM 內容與屬性操作需求。

copyright © 萬盛學電腦網 all rights reserved