QCheckbox 元件是用戶輸入的另一個基本元素。您可以使用它為用戶提供切換選項的方式。
提示
另請參考 QOptionGroup，了解建立核取方塊群組的其他可能性。
用法
標準
使用自訂圖示v2.5+
標籤
色彩
在下方範例的第二列中，屬性 keep-color 用於在核取方塊未切換狀態時，保留傳入的顏色。
緊湊
強制深色模式
尺寸
除了下方的標準尺寸外，您還可以透過 size 屬性定義自己的尺寸（最後一個是自訂尺寸）。
不確定狀態
在下方範例中，當您點擊第一個核取方塊時，它會立即開始在 true/false 之間切換。另一方面，第二個核取方塊借助 toggle-indeterminate 在三種狀態（不確定/true/false）之間切換。您可以選擇性地設定屬性 indeterminate-value，否則不確定值將被視為 null。
切換順序
預設情況下，QCheckbox 在切換時遵循此鏈：不確定 -> 已核取 -> 未核取。但是，您可以透過 toggle-order 屬性變更此行為。此屬性決定狀態的順序，可以是 tf（預設）或 ft（t 代表 true/已核取的狀態，而 f 代表 false/未核取的狀態）。
切換順序為
- 如果
toggle-indeterminate為 true，則：不確定 -> 第一個狀態 -> 第二個狀態 -> 不確定（並重複） - 否則（沒有 toggle-indeterminate）：不確定 -> 第一個狀態 -> 第二個狀態 -> 第一個狀態 -> 第二個狀態 -> …
陣列模型
自訂模型值
搭配 QOptionGroup
提示
您也可以使用 QOptionGroup，當您有核取方塊群組時，它可以簡化使用方式，如下方範例所示。
搭配 QItem
在下方範例中，我們正在渲染一個 <label> 標籤（請注意 tag="label"），因此 QCheckbox 將回應 QItem 上的點擊以變更切換狀態。
停用
原生表單提交
當處理具有 action 和 method 的原生表單時（例如，當搭配 ASP.NET 控制器使用 Quasar 時），您需要在 QCheckbox 上指定 name 屬性，否則 formData 將不會包含它（如果應該包含）- 所有值都會轉換為字串（原生行為，因此請勿使用物件值）