核取方塊小器具 (主題化)
「核取方塊」小器具可讓您將核取方塊新增至混搭，並可讓使用者選取核取方塊選項。
 |
「核取方塊」小器具可作為平台中的標準小器具使用，也可作為可從 SDL 匯入的 web 元件使用。
|
核取方塊小器具的內容如下所列。
|
屬性名稱
|
描述
|
基礎類型
|
預設值
|
可繫結? (Y/N)
|
可當地語系化? (Y/N)
|
||
|---|---|---|---|---|---|---|---|
|
State
|
可讓您將核取方塊小器具的狀態設定為已選取或未選取。
|
布林值
|
False
|
Y
|
N
|
||
|
Disabled
|
使用此內容可禁用混搭中的核取方塊小器具。小器具會顯示在混搭中，但您無法按一下。
|
布林值
|
False
|
Y
|
N
|
||
|
PartialState
|
可讓您使父核取方塊處於部份核取狀態，  。 |
布林值
|
False
|
Y
|
N
|
||
|
Label
|
顯示在小器具中靠近核取方塊位置的文字。
|
STRING
|
核取方塊
|
Y
|
Y
|
||
|
CustomClass
|
可讓您定義小器具頂部 div 元素的 CSS。可輸入多個類別，之間以空格分隔。
|
STRING
|
n/a
|
Y
|
N
|
||
|
LabelMaxWidth
|
可讓您設定標籤的最大寬度，達到最大寬度時，標籤會以多行顯示。
|
NUMBER
|
n/a
|
N
|
N
|
||
|
TabSequence
|
使用者按下 Tab 鍵時小器具反白的順序。
|
NUMBER
|
n/a
|
N
|
N
|
||
|
Changed
|
修改此小器具的狀態時所觸發的事件。
|
n/a
|
n/a
|
Y
|
N
|
||
|
ResetToDefaultValue
|
將此小器具的輸入重設為其預設值。
|
n/a
|
n/a
|
Y
|
N
|
||
|
Width
|
小器具寬度。寬度依預設會設定為標籤的寬度。在內容面板中輸入值或將畫布中的小器具重定大小，以設定固定寬度。
|
NUMBER
|
n/a
|
N
|
N
|
||
|
Height
|
小器具高度。高度依預設會設定為標籤的最大寬度。如果小器具有多行標籤，高度會增加。在內容面板中輸入值或將畫布中的小器具重定大小，以設定固定高度。
|
NUMBER
|
n/a
|
N
|
N
|
||
|
TooltipField
|
設定將游標置於小器具上時顯示的工具提示文字。
|
STRING
|
n/a
|
Y
|
Y
|
||
|
TooltipIcon
|
為小器具的工具提示設定圖示圖像。
您可以新增圖像或指定圖像 URL 路徑。
|
MEDIA ENTITY
|
n/a
|
N
|
N
|
驗證核取方塊小器具狀態
您可以使用 TrueRequired 內容來強制使用者在執行時間選取核取方塊。使用 RequiredMessage 內容可設定在未選取核取方塊時的失敗訊息。
如需有關驗證內容的詳細資訊，請參閱將驗證套用至小器具。
下表列出了 ThingWorx 9.3.4 或更新版本中「驗證」面板上的可用驗證內容。
內容 | 描述 | 基礎類型 | 預設值 | 是否可繫結 (Y/N) | 可當地語系化 (Y/N) |
|---|---|---|---|---|---|
CriteriaMessage | 為驗證條件以及驗證失敗時顯示的訊息。 | STRING | n/a | Y | Y |
CriteriaMessageDetails | 為驗證條件和失敗訊息顯示的詳細資訊。 | STRING | n/a | Y | Y |
RequiredMessage | 需要選取且未選取核取方塊時顯示的訊息。 | STRING | 必須選取核取方塊 | Y | Y |
ShowValidationCriteria | 編輯核取方塊時，顯示有關所需輸入的提示訊息。 | 布林值 | False | Y | N |
ShowValidationFailure | 當所輸入值未通過驗證時顯示失敗訊息。 | 布林值 | False | Y | N |
ShowValidationSuccess | 當所輸入值成功通過驗證時，顯示成功訊息。 | 布林值 | False | Y | N |
SuccessMessage | 驗證成功時顯示的訊息。 | STRING | n/a | Y | Y |
SuccessMessageDetails | 顯示有關驗證成功訊息之詳細資訊的次要訊息。 | STRING | n/a | Y | Y |
Validate | 小器具值變更時觸發的事件。將此事件繫結至服務或函數以套用驗證模式或運算式。 | event | n/a | Y | N |
ValidationCriteriaIcon | 選取要在驗證條件的提示訊息中顯示的 SVG 圖示。 | IMAGELINK | info | N | N |
ValidationFailureIcon | 設定當驗證失敗時要在狀況訊息中顯示的 SVG 圖示。 | IMAGELINK | error | N | N |
ValidationOutput | 擷取小器具驗證的輸出。傳回的值為 Undefined、Valid、Unvalidated 或 Invalid。 | STRING | n/a | Y | N |
ValidationState | 這是設定驗證狀態的可繫結內容。您可以將此內容設定為 Undefined、Unvalidated、Valid、Invalid。 | STRING | Undefined | Y | N |
ValidationSuccessIcon | 選取當驗證成功時要在訊息中顯示的 SVG 圖示。 | IMAGELINK | success | N | N |
TrueRequired | 需選取清單中某一項目。 | 布林值 | False | Y | N |