萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

HTML Checkbox 不確定狀態 (indeterminate) 實作:三態核取方塊完整指南

原生 <input type="checkbox"> 僅有「勾選/未勾選」兩態,但巢狀選單、全選功能常需「部分選中」第三態。透過 JavaScript indeterminate 屬性可實現視覺三態,不影響表單提交值。

核心實作

<input type="checkbox" id="parentCb">
<script>
const cb = document.getElementById('parentCb');

// 三態控制函式
function setChecked()   { cb.indeterminate = false; cb.checked = true;  }
function setUnchecked() { cb.indeterminate = false; cb.checked = false; }
function setPartial()   { cb.indeterminate = true;  /* checked 保持原狀 */ }
</script>
<button onclick="setChecked()">全選</button>
<button onclick="setUnchecked()">全不選</button>
<button onclick="setPartial()">部分選中</button>

關鍵特性

  • indeterminate 僅能透過 JS 設定,HTML 屬性無效
  • 視覺呈現:瀏覽器通常顯示「方塊中橫線」或「陰影勾選」
  • 不影響表單值:提交時仍以 checked 決定是否送出 name=value
  • 需手動同步子項狀態:子項變更時重新計算父項 indeterminate

巢狀選單完整邏輯範例

function updateParentState(parentId, childSelector) {
  const parent = document.getElementById(parentId);
  const children = document.querySelectorAll(childSelector);
  const checked = [...children].filter(c => c.checked).length;
  
  if (checked === 0) { parent.checked = false; parent.indeterminate = false; }
  else if (checked === children.length) { parent.checked = true; parent.indeterminate = false; }
  else { parent.indeterminate = true; }
}

// 子項變更監聽
document.querySelectorAll('.child-cb').forEach(cb => 
  cb.addEventListener('change', () => updateParentState('parentCb', '.child-cb'))
);

// 父項點擊切換全選/全不選
document.getElementById('parentCb').addEventListener('click', function() {
  if (this.indeterminate) { this.indeterminate = false; this.checked = true; }
  const state = this.checked;
  document.querySelectorAll('.child-cb').forEach(cb => cb.checked = state);
});

checked 屬性初始化陷阱

HTML 中出現 checked(無論值為何)皆視為勾選狀態:

<input type="checkbox" checked>           <!-- 勾選 -->
<input type="checkbox" checked="true">     <!-- 勾選 -->
<input type="checkbox" checked="false">    <!-- 勾選! -->
<input type="checkbox" checked="">         <!-- 勾選 -->

正確未勾選寫法:完全省略 checked 屬性。

copyright © 萬盛學電腦網 all rights reserved