复选框小组件 (可应用主题)
“复选框”小组件可用于将复选框添加到您的混搭中，并允许用户选择复选框选项。
 |
“复选框”小组件可在平台中作为标准版小组件使用，也可用作 web 组件 (可从 SDK 导入)。
|
下面列出了复选框小组件的属性。
|
属性名称
|
说明
|
基本类型
|
默认值
|
是否可绑定? (Y/N)
|
是否可本地化? (Y/N)
|
||
|---|---|---|---|---|---|---|---|
|
State
|
用于将复选框小组件的状态设置为选中或未选中。
|
BOOLEAN
|
False
|
Y
|
N
|
||
|
Disabled
|
使用此属性可以禁用混搭中的复选框小组件。小组件将显示在混搭中，但不能单击。
|
BOOLEAN
|
False
|
Y
|
N
|
||
|
PartialState
|
使您能够将父项复选框置于部分选中状态  。 |
BOOLEAN
|
False
|
Y
|
N
|
||
|
Label
|
此复选框附近的小组件中显示的文本。
|
STRING
|
复选框
|
Y
|
Y
|
||
|
CustomClass
|
用于定义要应用于小组件顶层 div 元素的 CSS 类。可以输入多个类，以空格作为分隔符。
|
STRING
|
不适用
|
Y
|
N
|
||
|
LabelMaxWidth
|
用于设置标签的最大宽度，当达到最大宽度时，系统会以多行显示标签。
|
NUMBER
|
不适用
|
N
|
N
|
||
|
TabSequence
|
用户按下 Tab 键时，小组件将在该序列中突出显示。
|
NUMBER
|
不适用
|
N
|
N
|
||
|
Changed
|
修改此小组件的状态时所触发的事件。
|
不适用
|
不适用
|
Y
|
N
|
||
|
ResetToDefaultValue
|
将此小组件的输入重置为其默认值。
|
不适用
|
不适用
|
Y
|
N
|
||
|
Width
|
小组件宽度。默认情况下，宽度将设置为标签的宽度。在属性面板中输入一个值，或在工作区中调整小组件的大小，以设置固定的宽度。
|
NUMBER
|
不适用
|
N
|
N
|
||
|
Height
|
小组件高度。默认情况下，高度将设置为标签的最大宽度。如果小组件具有多行标签，则高度会增加。在属性面板中输入一个值，或在工作区中调整小组件的大小，以设置固定的高度。
|
NUMBER
|
不适用
|
N
|
N
|
||
|
TooltipField
|
设置当您将光标悬停在小组件上时显示的工具提示文本。
|
STRING
|
不适用
|
Y
|
Y
|
||
|
TooltipIcon
|
设置小组件工具提示的图标图像。
可添加图像或指定图像 URL 路径。
|
MEDIA ENTITY
|
不适用
|
N
|
N
|
验证复选框小组件状态
可使用 TrueRequired 属性强制用户在运行时选择复选框。如果未选中复选框，则使用 RequiredMessage 属性设置失败消息。
有关验证属性的详细信息，请参阅将验证应用于小组件。
下表列出了 ThingWorx 9.3.4 或更高版本中“验证”面板上的可用验证属性。
属性 | 说明 | 基本类型 | 默认值 | 是否可绑定 (Y/N) | 是否可本地化 (Y/N) |
|---|---|---|---|---|---|
CriteriaMessage | 有关验证条件以及验证失败时显示的消息。 | STRING | 不适用 | Y | Y |
CriteriaMessageDetails | 针对验证条件和失败消息显示的详细信息。 | STRING | 不适用 | Y | Y |
RequiredMessage | 必须选中但未选中复选框时显示的消息。 | STRING | 必须选中复选框 | Y | Y |
ShowValidationCriteria | 编辑复选框时显示有关所需输入的提示消息。 | BOOLEAN | False | Y | N |
ShowValidationFailure | 当输入的值验证失败时，显示失败消息。 | BOOLEAN | False | Y | N |
ShowValidationSuccess | 当输入的值验证成功时，显示成功消息。 | BOOLEAN | False | Y | N |
SuccessMessage | 验证成功时显示的消息。 | STRING | 不适用 | Y | Y |
SuccessMessageDetails | 二级消息，显示关于验证成功消息的更多信息。 | STRING | 不适用 | Y | Y |
Validate | 更改小组件值时触发的事件。将此事件绑定至服务或函数以应用验证模式或表达式。 | 事件 | 不适用 | Y | N |
ValidationCriteriaIcon | 针对关于验证条件的提示消息，选择在其中显示的 SVG 图标。 | IMAGELINK | info | N | N |
ValidationFailureIcon | 设置验证失败时显示在状况消息中的 SVG 图标。 | IMAGELINK | error | N | N |
ValidationOutput | 检索小组件验证的输出。返回值为 Undefined、Valid、Unvalidated 或 Invalid。 | STRING | 不适用 | Y | N |
ValidationState | 用于设置验证状态的可绑定属性。可将此属性设置为 Undefined、Unvalidated、Valid 和 Invalid。 | STRING | Undefined | Y | N |
ValidationSuccessIcon | 选择验证成功时显示在消息中的 SVG 图标。 | IMAGELINK | success | N | N |
TrueRequired | 需要选择列表内的其中一项。 | BOOLEAN | False | Y | N |