萬盛學電腦網

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

jQuery 操作 hidden、disabled 等布林屬性:正確用法與常見誤區

HTML 布林屬性正確寫法

<!-- ❌ 錯誤:無值屬性在 IE 中不生效 -->
<input name="role_name" id="role_name" value="Roy" disabled>
<input name="role_id" id="role_id" hidden value="3312">

<!-- ✅ 標準:屬性名=屬性名 -->
<input name="role_name" id="role_name" value="Roy" disabled="disabled">
<input name="role_id" id="role_id" hidden="hidden" value="3312">

jQuery 操作:prop() 是首選

// 移除 disabled / hidden
$('#role_name').prop('disabled', false);
$('#role_id').prop('hidden', false);

// 等價於 removeAttr(但 prop 更語意化)
$('#role_name').removeAttr('disabled');
$('#role_id').removeAttr('hidden');

// 設置為 true
$('#role_name').prop('disabled', true);
$('#role_id').prop('hidden', true);

prop() 回傳布林值,便於判斷

if ($('#role_name').prop('disabled')) {
  console.log('按鈕已禁用');
}

// 切換狀態
$('#toggleBtn').click(function() {
  var $input = $('#role_name');
  $input.prop('disabled', !$input.prop('disabled'));
});

checkbox / radio 同樣適用

<input type="checkbox" id="agree">

// 勾選
$('#agree').prop('checked', true);

// 取消勾選
$('#agree').prop('checked', false);

// 切換
$('#agree').prop('checked', !$('#agree').prop('checked'));

// 讀取狀態
var agreed = $('#agree').prop('checked');  // true/false

// ❌ 不要用 attr('checked') - 只反映初始 HTML,不反映當前狀態
// ✅ 正確用 prop() 或 is(':checked')
var agreed2 = $('#agree').is(':checked');

attr() vs prop() 對照表

屬性正確方法錯誤方法說明
disabled.prop('disabled', true/false).attr('disabled', ...)布林 DOM 屬性
hidden.prop('hidden', true/false).attr('hidden', ...)HTML5 布林屬性
checked.prop('checked', true/false).attr('checked', ...)動態狀態必須用 prop
selected.prop('selected', true/false).attr('selected', ...)option 元素
readonly.prop('readonly', true/false).attr('readonly', ...)
href, src, id, name, class.attr().prop()HTML 屬性/字串值
value.val() / .prop('value').attr('value').val() 統一表單取值
data-*.data().attr('data-*').data() 有快取與轉型

實戰:表單編輯/檢視模式切換

function setFormMode($form, mode) {
  // mode: 'edit' | 'view'
  var isEdit = mode === 'edit';
  
  $form.find('input, select, textarea, button').each(function() {
    var $el = $(this);
    var tag = this.tagName.toLowerCase();
    var type = $el.attr('type');
    
    // 保護隱藏欄位不被禁用(需提交)
    if (type === 'hidden') return;
    
    if (isEdit) {
      $el.prop('disabled', false).removeAttr('readonly');
    } else {
      $el.prop('disabled', true);
      // 文字框加 readonly 保持可複製
      if (tag === 'input' && (type === 'text' || type === 'email' || type === 'number')) {
        $el.attr('readonly', 'readonly').prop('disabled', false);
      }
    }
  });
}

總結

  • 布林屬性(disabled、hidden、checked、selected、readonly)必須用 .prop()
  • HTML 屬性(href、src、id、name、class、data-*)用 .attr()
  • 表單值用 .val(),內部自動處理 prop/attr 差異
  • 標準 HTML 寫法 disabled="disabled" 確保跨瀏覽器相容
copyright © 萬盛學電腦網 all rights reserved