萬盛學電腦網

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

jQuery 切換 disabled 狀態的三種方式:布爾屬性、屬性值、removeAttr 差異與最佳實踐

表單控件禁用/啟用看似簡單,但 prop()、attr()、removeAttr() 行為差異大,易導致 Bug。本文釐清三種方式本質、jQuery 版本演進、TypeScript 類型、無障礙屬性同步、批量切換效能。

三種方式本質對比

方式代碼底層操作效果推薦度
布爾屬性$el.prop('disabled', true/false)設置 DOM disabled IDL 屬性標準、響應式、觸發瀏覽器原生禁用行為⭐⭐⭐⭐⭐ **首選**
屬性值$el.attr('disabled', 'disabled') / $el.attr('disabled', '')設置/移除 HTML disabled 屬性節點舊版 jQuery 行為、字符串值易混淆、不觸發 IDL 同步⭐⭐ 不推薦
移除屬性$el.removeAttr('disabled')移除 HTML 屬性節點啟用時等同 prop('disabled', false),但語意不清⭐⭐⭐ 可接受

正確代碼模式

// 禁用
$(':input').prop('disabled', true).attr('aria-disabled', 'true');

// 啟用
$(':input').prop('disabled', false).removeAttr('aria-disabled');

// 切換
$btn.on('click', () => {
  const $input = $('#myInput');
  $input.prop('disabled', !$input.prop('disabled'));
});

// 表單整體禁用(jQuery 3.0+)
$form.find(':input').prop('disabled', true);

jQuery 版本演進關鍵點

  • 1.6 前:attr() 同時處理屬性與屬性,行為混亂。
  • 1.6+:引入 prop() 專門處理 IDL 屬性(disabled、checked、selected、value 等),attr() 僅處理 HTML 屬性節點。
  • 3.0+:removeAttr('disabled') 內部調用 prop('disabled', false),行為統一。

TypeScript 類型安全

// @types/jquery
$input.prop('disabled', true); // ok
$input.prop('disabled', 'true'); // TS 錯誤:類型 "string" 不可分配給 "boolean"
$input.attr('disabled', 'disabled'); // ok,但語意不推薦

無障礙同步

function setDisabled($el, disabled) {
  $el.prop('disabled', disabled);
  if (disabled) $el.attr('aria-disabled', 'true');
  else $el.removeAttr('aria-disabled');
}

效能:批量操作

// ❌ 差:每次 prop 觸發佈局檢查
inputs.forEach(el => $(el).prop('disabled', true));

// ✅ 好:原生批量,單次重排
const inputs = document.querySelectorAll('input,select,textarea,button');
inputs.forEach(el => el.disabled = true);

// ✅ 也可:jQuery 內部優化
$(':input').prop('disabled', true); // 內部循環設置 DOM 屬性,無額外開銷
copyright © 萬盛學電腦網 all rights reserved