表單控件禁用/啟用看似簡單,但 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);
attr() 同時處理屬性與屬性,行為混亂。prop() 專門處理 IDL 屬性(disabled、checked、selected、value 等),attr() 僅處理 HTML 屬性節點。removeAttr('disabled') 內部調用 prop('disabled', false),行為統一。// @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 屬性,無額外開銷