萬盛學電腦網

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

jQuery attr() 方法完整指南:設定、批量、回調與 prop() 差異

attr() vs prop():核心區別

特性.attr().prop()
操作對象HTML 屬性DOM 屬性
布林屬性回傳字串或 undefined回傳 true/false
適用場景自定義屬性、href、src、id、namechecked、disabled、selected、value、hidden
版本建議jQuery 1.6+ 區分明確jQuery 1.6+ 引入

基本用法:設定單一屬性

// 設定 href
$('button').click(function() {
  $('#keleyi').attr('href', 'https://www.jb51.net');
});

批量設定多個屬性

$('button').click(function() {
  $('#keleyi').attr({
    'href': 'https://www.jb51.net',
    'title': '柯樂義網',
    'target': '_blank'
  });
});

回調函數:基於舊值計算新值

// 在原 href 後附加路徑
$('button').click(function() {
  $('#keleyi').attr('href', function(i, origValue) {
    return origValue + '/jquery';
  });
});

關鍵場景:布林屬性必須用 prop()

<input id="chk" type="checkbox">
<input id="btn" type="button" disabled>
<div id="box" hidden>內容</div>

// ❌ 錯誤:attr 設定布林屬性
$('#chk').attr('checked', true);      // 可能不生效
$('#btn').attr('disabled', false);    // 不生效
$('#box').attr('hidden', false);      // 不生效

// ✅ 正確:prop 設定布林屬性
$('#chk').prop('checked', true);      // 勾選
$('#btn').prop('disabled', false);    // 啟用
$('#box').prop('hidden', false);      // 顯示

// 讀取狀態
var isChecked = $('#chk').prop('checked');  // true/false
var isDisabled = $('#btn').prop('disabled'); // true/false

移除屬性

// 移除 HTML 屬性
$('#element').removeAttr('data-custom');

// 移除 DOM 屬性(罕用)
$('#element').removeProp('customProp');  // 謹慎使用,可能導致不可逆

實戰:表單編輯狀態切換

function toggleEditMode($form, editable) {
  $form.find('input, select, textarea').each(function() {
    var $el = $(this);
    if (editable) {
      $el.prop('disabled', false).removeAttr('readonly');
    } else {
      $el.prop('disabled', true).attr('readonly', 'readonly');
    }
  });
}

// 使用
$('#editBtn').click(function() { toggleEditMode('#myForm', true); });
$('#viewBtn').click(function() { toggleEditMode('#myForm', false); });

HTML5 data-* 屬性:建議用 .data()

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

// ✅ 推薦:.data() 自動轉型、快取
var id = $('#user').data('id');      // 123 (number)
var role = $('#user').data('role');  // 'admin'

// ⚠️ .attr() 總是回傳字串
var idStr = $('#user').attr('data-id');  // '123' (string)

// 寫入
$('#user').data('lastLogin', Date.now());  // 寫入快取,不更新 DOM
$('#user').attr('data-last-login', Date.now());  // 寫入 DOM 屬性

總結

  • href、src、id、name、data-*(讀取)、自定義屬性 → .attr()
  • checked、disabled、selected、hidden、value、readonly、tabIndex → .prop()
  • data-* 寫入/讀取 → .data()(快取、自動轉型)
  • 批量設定用物件語法 .attr({...}),動態計算用回調函數
copyright © 萬盛學電腦網 all rights reserved