확인란 위젯(테마 적용 가능)
확인란 위젯을 사용하면 매쉬업에 확인란이 추가되어 사용자가 확인란 옵션을 선택할 수 있습니다.
 |
확인란 위젯은 플랫폼에서 표준 위젯으로, 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 경로를 지정할 수 있습니다.
|
미디어 엔티티
|
해당 없음
|
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 | 위젯 값이 변경될 때 트리거되는 이벤트입니다. 이 이벤트를 서비스 또는 함수에 바인딩하여 유효성 검사 패턴 또는 식을 적용합니다. | event | 해당 없음 | Y | N |
ValidationCriteriaIcon | 유효성 검사 조건에 대해 힌트 메시지 내에 표시할 SVG 아이콘을 선택합니다. | IMAGELINK | info | N | N |
ValidationFailureIcon | 유효성 검사에 실패했을 때 상태 메시지 내에 표시할 SVG 아이콘을 설정합니다. | IMAGELINK | error | N | N |
ValidationOutput | 위젯 유효성 검사의 출력을 검색합니다. 반환된 값은 Undefined, Unvalidated, Valid 또는 Invalid입니다. | STRING | 해당 없음 | Y | N |
ValidationState | 유효성 검사 상태를 설정하는 바인딩 가능한 속성입니다. 이 속성을 Undefined, Unvalidated, Valid, Invalid로 설정할 수 있습니다. | STRING | Undefined | Y | N |
ValidationSuccessIcon | 유효성 검사에 성공했을 때 메시지 내에 표시할 SVG 아이콘을 선택합니다. | IMAGELINK | success | N | N |
TrueRequired | 목록에서 항목을 선택해야 합니다. | BOOLEAN | False | Y | N |