확인란 위젯(테마 적용 가능)
확인란 위젯을 사용하면 매쉬업에 확인란이 추가되어 사용자가 확인란 옵션을 선택할 수 있습니다.
 |
확인란 위젯은 플랫폼에서 표준 위젯으로, 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 속성을 사용합니다.
유효성 검사 속성에 대한 자세한 내용은 위젯에 유효성 검사 적용을 참조하십시오.
다음 표에는 유효성 검사 패널에서 사용 가능한 유효성 검사 속성이 나열되어 있습니다.
|
속성
|
설명
|
기본 유형
|
기본값
|
바인딩 가능 여부(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
|