Toggle

QToggle 组件是采集用户输入的一个基本元素。您可以使用它为用户提供设置开关切换或者真假值输入功能。

TIP

关于创建一组选项框的其他可能性,请参阅 QOptionGroup

QToggle API

Loading QToggle API...

用法

基础

使用 color 属性来控制开关的颜色




带有标签




保留颜色




带有图标




自定义 model 值

您可以自定义 model 的值来替换默认的 true/false




不定状态

在下面的示例中,只要单击第一个 QToggle,它就开始在真/假之间切换。然而,第二个 QToggle 通过设置toggle-indeterminate 属性可以在三种状态(不确定/真/假)之间切换。您可以选择设置 indeterminate-value,否则不确定的值将被视为 null




切换顺序

默认情况下,QToggle 在点击时按照下述顺序切换值:indeterminate -> checked -> unchecked。但是您可以通过 toggle-order 属性来修改此行为。这个属性决定了切换状态的顺序是 tf(默认),或者 ftt 表示 true/checked 状态,f 表示 false/unchecked 状态)

切换顺序:

  • 如果 toggle-indeterminate 是 true,那么:indet -> first state -> second state -> indet (依次循环)
  • 否则: indet -> first state -> second state -> first state -> second state -> …



数组 model

如果有多个开关,则可以使用数组作为所有开关的 数据 model,并在每个开关上指定 val 属性。如果勾选该开关,其 val 将插入数组,反之亦然。




黑色和禁用







大小

除了下面的标准尺寸,您可以通过 size 属性定义自己的尺寸(最后一个示例是自定义尺寸)。




搭配 QOptionGroup

TIP

您还可以使用 QOptionGroup,当您有多组开关时,它可以简化使用,如下面的示例所示。




搭配 QItem




原生表单提交

当处理一个带有 actionmethod 的原生表单时(如:使用 Quasar 和 ASP.NET 控制器时),您需要为 QToggle 声明 name 属性,否则表单数据中不会包含它: