매쉬업 작성기 > 위젯 > 표준 위젯 > 속성 표시 위젯(테마 적용 가능)
속성 표시 위젯(테마 적용 가능)
속성 표시 위젯을 사용하여 매쉬업에 키-값 쌍의 구조화된 그룹을 표시할 수 있습니다.
* 
속성 표시 위젯은 플랫폼에서 표준 위젯으로, SDK에서 가져올 수 있는 웹 구성 요소로 사용할 수 있습니다.
데이터 형식
위젯에 속성을 표시하려면 다음 데이터 형식에 따라 인포테이블을 반환하는 데이터 서비스를 바인딩해야 합니다.
열 1
...
열 N
...
사용
위젯의 속성 이름을 정의합니다.
...
각 추가 열에 대한 속성 이름을 정의합니다.
인포테이블의 각 행은 정의된 열에 해당하는 값 집합을 나타냅니다. 위젯은 행 값과 열 이름을 쌍으로 표시합니다. 이는 인포테이블의 각 행에 대해 반복됩니다. 실행 시간 시 데이터 셰이프의 각 인포테이블 열에 대한 기본 유형을 기준으로 위젯 서식 적용이 자동으로 설정됩니다.
GroupNameField 속성을 사용하여 공통 레이블 아래의 속성을 그룹화할 수 있습니다. 테이블 형식 레이아웃을 사용하여 속성과 값을 표시하려면 TableLayout 속성을 활성화합니다.
속성 그룹화
구성 대화 상자를 사용하여 특정 열을 숨기거나 이름을 바꾸지 않으면 기본적으로 나열된 속성이 바인딩된 인포테이블의 형식에 따라 표시됩니다. 모든 속성은 실행 시간 시 동일한 수준에 표시됩니다. 그룹화를 사용하여 단일 항목에 속하는 속성을 구성할 수 있습니다. 그룹화가 사용되면 바인딩된 인포테이블의 데이터 열을 사용하여 위젯의 각 속성 그룹에 대한 레이블을 지정할 수 있습니다.
예를 들어, 나열된 두 항목의 속성을 반환하는 다음 인포테이블을 살펴보겠습니다.
Name
TopSpeed
MaxRange
MaxAltitude
Heavy Aircraft
250 kn
3800 nmi
28000 ft
Light Aircraft
150 kn
700 nmi
12000 ft
실행 시간 시 Heavy Aircraft는 Name 아래의 속성 값으로 표시됩니다.
Name 열의 값을 속성에 대한 그룹 레이블로 사용하려면 GroupNameField 위젯 속성을 설정합니다.
1. 속성 표시 위젯을 선택한 다음 속성 패널을 엽니다. 위젯 속성이 나열됩니다.
2. 속성의 레이블로 사용할 STRING 기본 유형의 인포테이블 열을 선택하여 GroupNameField 속성을 설정합니다.
* 
인포테이블을 Data 속성에 바인딩하지 않고는 이 속성을 설정할 수 없습니다.
3. 저장을 클릭한 다음 매쉬업을 봅니다.
실행 시간 시 선택한 열의 값은 각 행의 모든 속성을 그룹화하는 데 사용됩니다. 다음 이미지에서는 Name 열의 값을 사용하여 그룹화된 속성이 있는 이전 예를 보여줍니다.
구현 및 설계에 따라 인포테이블의 다른 것을 사용하여 속성을 그룹화할 수 있습니다. 이를 통해 속성을 구성하고 정렬할 수 있습니다.
속성 목록 구성
각 행의 속성 목록은 인포테이블의 열 순서에 따라 정렬됩니다. 열 이름은 바인딩된 인포테이블에 대한 데이터 셰이프의 필드 정의에 의해 결정됩니다. 열 구성 대화 상자를 사용하여 속성의 기본 순서를 재정의할 수 있습니다.
캔버스에서 위젯을 선택한 후 다음 방법 중 하나로 위젯 구성 대화 상자를 엽니다.
• 캔버스에서 위젯의 왼쪽 위 모서리에 있는 아래쪽 화살표를 클릭한 다음 그리드 열 구성을 클릭합니다.
• 또는 속성 패널에서 을 클릭합니다.
위젯 구성 대화 상자가 열립니다.
• 속성의 순서를 다시 매기려면 왼쪽 창에서 열을 끌어 필요에 따라 순서를 변경합니다. 목록에서 열을 위/아래로 이동할 수 있습니다. 속성의 순서가 이에 따라 실행 시간 시 왼쪽에서 오른쪽으로 변경됩니다.
• 속성 이름을 변경하려면 왼쪽 창에서 열을 선택한 다음 속성에 대해 표시할 새 레이블을 입력합니다. 로컬리제이션 토큰을 선택하려면 로컬리제이션 토큰을 클릭한 다음 목록에서 토큰을 선택합니다.
• 실행 시간 시 특정 속성을 숨기려면 표시 아래에 있는 확인란의 선택을 취소합니다.
* 
• GroupNameField 속성에 대한 열을 선택하면 해당 열이 나열되지 않고 기존 구성이 모두 무시됩니다.
완료를 클릭하여 변경 사항을 적용하고 대화 상자를 닫습니다.
위젯 속성
다음 표에는 위젯 속성이 나열되어 있습니다.
속성 이름
설명
기본 유형
기본값
바인딩 가능 여부 (Y/N)
로컬리제이션 가능 여부 (Y/N)
VerticalMode
세로 축을 따라 데이터를 정렬합니다. 선택하지 않으면 가로로 표시됩니다.
BOOLEAN
False
Y
N
HideGroupTitles
그룹 제목 레이블을 숨깁니다.
BOOLEAN
False
Y
N
ModalWidth
모달 창의 고정 너비를 설정합니다.
* 
이미지에 대한 모달 창의 경우 고정 너비 설정이 적용되지 않습니다. 이미지의 치수에 따라 창 크기가 자동으로 조정됩니다.
NUMBER
해당 없음
Y
N
ModalHeight
모달 창의 고정 높이를 설정합니다.
* 
이미지에 대한 모달 창의 경우 고정 높이 설정이 적용되지 않습니다. 이미지의 치수에 따라 창 크기가 자동으로 조정됩니다.
NUMBER
해당 없음
Y
N
CustomClass
위젯의 최상위 div에 대한 CSS를 정의합니다. 여러 클래스를 입력할 때는 각 클래스를 공백으로 구분합니다.
STRING
해당 없음
Y
N
DisclosureControl
위젯에 대해 지정된 치수를 초과할 때 전체 값을 표시하는 방법을 지정합니다. 전체 값이 표시되는 방법은 선택한 항목에 따라 달라집니다.
• 정보 버튼 표시 - 모달 창에 표시됩니다.
• '자세히 표시...' 링크 사용 - 자세히 표시 링크를 사용합니다.
• 줄임표 표시(...) - 줄임표를 사용합니다.
* 
• 이미지는 항상 기본적으로 모달 창에서 열립니다.
• 줄임표 표시(...)를 선택하면 ValueMaxHeight 속성이 전체 값을 제한하고 자릅니다.
STRING
정보 버튼 표시
N
N
MultiLine
지정한 너비를 초과할 때 텍스트가 새 줄에서 계속 이어지도록 설정합니다.
BOOLEAN
False
TextIfNoValue
위젯 데이터 소스에 값이 포함되지 않을 때 표시되는 텍스트를 설정합니다.
STRING
해당 없음
Y
Y
Disabled
매쉬업에서 위젯을 비활성화합니다. 위젯이 나타나지만 사용할 수는 없습니다.
BOOLEAN
False
Y
N
TabSequence
TAB을 누를 때 위젯이 강조 표시되는 순서를 설정합니다.
NUMBER
해당 없음
N
N
Data
속성 표시에 대한 데이터 소스입니다.
* 
• 인포테이블의 각 행은 속성 표시의 키-값 쌍 하나에 해당합니다.
• 인포테이블 행의 각 필드는 행에서 생성된 키-값 쌍에 레이블과 값이 있는 하나의 엔트리를 생성합니다.
각 엔트리의 레이블은 인포테이블 데이터 셰이프에 의해 정의된 대로 필드 이름에서 파생됩니다.
• 필드에 데이터 셰이프 정의에 정의된 표시 이름이 있는 경우 이 이름이 사용됩니다.
• 필드의 이름이 데이터 셰이프 정의에 정의되어 있지 않으면 현재 로컬리제이션 테이블의 필드 이름이 선택됩니다.
• 위의 두 시나리오 중 하나라도 수행되지 않는 경우 필드 이름 자체가 레이블로 사용됩니다.
각 필드의 값이 엔트리 값으로 사용됩니다. 이 값의 유형은 데이터 셰이프에 정의된 대로 필드 유형에 의해 자동으로 결정됩니다. 이를 구성할 필요가 없습니다. 예를 들어, IMAGE 유형의 필드는 이미지로 표시됩니다.
INFOTABLE
해당 없음
Y
N
GroupNameField
속성을 그룹화하는 데 사용되는 인포테이블 필드를 지정합니다.
* 
인포테이블 필드는 STRING 기본 유형이어야 합니다.
이 속성은 그룹 제목으로 사용할 인포테이블의 필드 중 하나를 선택합니다. 이 속성이 설정되면 이 필드의 값이 그룹 제목으로 사용되고 이 필드는 다른 속성 간에 표시되지 않습니다. GroupNameField로 선택된 필드가 없는 경우 이 속성 표시 위젯에 모든 필드가 표시되고 그룹에 제목이 표시되지 않습니다.
INFOTABLE
해당 없음
N
N
Label
속성 표시 위젯에 대한 레이블 텍스트를 표시합니다.
STRING
해당 없음
Y
Y
LabelAlignment
레이블을 가로 축을 따라 왼쪽, 오른쪽 또는 가운데에 정렬합니다.
STRING
왼쪽
N
N
LabelType
레이블 유형을 머리글, 하위 머리글, 레이블 또는 본문으로 설정합니다.
STRING
레이블
N
N
HideLabel
매쉬업에서 레이블을 숨깁니다.
BOOLEAN
False
N
N
GroupTitleAlignment
그룹 레이블을 가로 축을 따라 왼쪽, 오른쪽 또는 가운데에 정렬합니다.
STRING
왼쪽
N
N
GroupTitleType
그룹 제목의 유형을 머리글, 하위 머리글, 레이블 또는 본문으로 설정합니다.
STRING
레이블
N
N
TableLayout
속성 목록과 해당 값을 테이블 레이아웃 내의 행과 열로 표시합니다.
BOOLEAN
False
N
N
KeyColumnWidth
테이블 레이아웃을 사용하여 위젯을 구성할 때 속성 이름을 표시하는 데 사용되는 열 너비를 설정합니다.
NUMBER
해당 없음
N
N
ValueMaxWidth
값에 대한 최대 너비를 설정합니다.
* 
이 속성은 MultiLine 및 VerticalMode를 선택한 경우에만 사용할 수 있습니다.
NUMBER
해당 없음
Y
N
ValueMaxHeight
값에 대한 최대 높이를 설정합니다.
* 
이 속성은 MultiLine 및 VerticalMode를 선택한 경우에만 사용할 수 있습니다.
NUMBER
해당 없음
Y
N
도움이 되셨나요?