QToggle 组件是采集用户输入的一个基本元素。您可以使用它为用户提供设置开关切换或者真假值输入功能。
TIP
关于创建一组选项框的其他可能性,请参阅 QOptionGroup。
用法
基础
使用 color 属性来控制开关的颜色。
带有标签
保留颜色
带有图标
自定义模型值
您可以使用自定义值代替默认的 true/false 值。
不确定状态
在下面的示例中,只要单击第一个 QToggle,它就开始在 true/false 之间切换。另一方面,第二个 QToggle 在 toggle-indeterminate 的帮助下在三种状态(不确定/true/false)之间切换。您可以选择设置 indeterminate-value 属性,否则不确定值将被视为 null。
切换顺序
默认情况下,QToggle 在切换时遵循以下链:不确定 -> 选中 -> 未选中。但是,您可以通过 toggle-order 属性更改此行为。此属性确定状态的顺序,可以是 tf(默认)或 ft(t 代表 true/checked 状态,而 f 代表 false/unchecked 状态)。
切换顺序是:
- 如果
toggle-indeterminate为 true,则:不确定 -> 第一个状态 -> 第二个状态 -> 不确定(并重复) - 否则(无 toggle-indeterminate):不确定 -> 第一个状态 -> 第二个状态 -> 第一个状态 -> 第二个状态 -> …
数组模型
如果您有多个用于选择的开关,可以使用数组作为所有开关的模型,并在每个开关上指定 val 属性。如果开关被勾选,其 val 将被插入数组,反之亦然。
暗色设计
禁用
尺寸
除了下面的标准尺寸外,您还可以通过 size 属性定义自己的尺寸(最后一个是自定义尺寸)。
与 QOptionGroup 一起使用
TIP
您还可以使用 QOptionGroup,当您有多组开关时,它可以简化使用,如下面的示例所示。
与 QItem 一起使用
原生表单提交
当处理一个带有 action 和 method 的原生表单时(例如:当将 Quasar 与 ASP.NET 控制器一起使用时),您需要在 QToggle 上指定 name 属性,否则 formData 将不包含它(如果应该包含)- 所有值都转换为字符串(原生行为,所以不要使用对象值):