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