매쉬업 작성기 > 위젯 > 목록 위젯
목록 위젯
목록 위젯을 사용하면 모든 데이터 집합을 단일 열 목록 보기에 표시할 수 있습니다. 이 목록은 셀의 색상 컨텍스트 및 이미지 렌더링을 포함하여 단일 열을 렌더링하는 여러 가지 방법을 지원합니다. 목록 위젯의 속성을 통해 기본 렌더링 유형, 표시할 열 및 상태 서식 적용을 구성할 수 있습니다. 목록을 간단한 목록 상자, 콤보 상자, 드롭다운 목록 상자 또는 라디오 버튼 목록으로 표시하도록 구성할 수 있습니다.
목록 구성
데이터 서비스를 목록에 연결하면 위젯 속성 패널에 표시할 열을 선택할 수 있습니다.
데이터에 특정 렌더러를 사용하거나 상태 서식 적용을 사용하려면 ListFormat 속성 옆에 있는 렌더러상태 버튼을 누릅니다. 표시된 열의 경우 다음을 수행할 수 있습니다.
셀의 렌더러(표시할 데이터의 특정 데이터 유형 처리에 사용)를 선택할 수 있습니다.
스타일 지정(고정 또는 상태 서식 적용)을 선택할 수 있습니다.
고정(비동적) 스타일을 적용하려면 고정 스타일을 선택하고 이전에 정의한 스타일 정의를 선택합니다. 동적 서식 적용(행에서 데이터를 반환할 때 기반으로 하는 색상 컨텍스트 등)을 수행하려면 상태 기반 서식 적용을 선택합니다.
상태 기반 서식 적용을 사용하면 해당 행의 모든 열을 기반으로 목록의 행에 스타일을 적용할 수 있습니다. 상태 포맷터를 정의하려면 다음을 수행하십시오.
1. 서식 적용이 종속될 열(반환하는 데이터 서비스의 모든 열이 될 수 있음)을 선택합니다.
2. 표시된 열에 사용할 상태 정의를 선택합니다(종속 필드의 데이터 유형과 일치해야 함).
3. 상태 정의의 기본값을 수락하거나 이 목록 정의 및 렌더링을 위해 특별히 재정의합니다.
콤보 상자
콤보 상자를 사용하면 자동 완성 검색을 수행하여 드롭다운에서 옵션 목록의 범위를 좁힐 수 있습니다. Multiselect 속성(CTRL+SHIFT 키 사용의 대체)을 사용하면 모든 목록 항목 옆에 확인란을 추가할 수 있습니다.
다음 스타일 정의를 콤보 상자와 함께 사용할 수 있습니다.
ComboTextboxStyle
ComboDropdownButtonStyle
속성 이름
설명
기본 유형
기본값
바인딩 가능 여부 (Y/N)
로컬리제이션 가능 여부 (Y/N)
CustomClass
위젯의 최상위 div에 적용할 사용자 정의 CSS 클래스입니다. 여러 클래스를 공백으로 구분하여 입력할 수 있습니다.
STRING
해당 없음
Y
N
ListFormat
ListFormat 속성은 데이터에 대해 특정 렌더러를 적용하거나 고정 스타일 또는 상태 기반 서식 적용을 표시된 데이터에 적용하는 데 사용됩니다.
해당 없음
렌더러 및 상태 값 서식 적용
N
N
MultiSelect
목록에서 여러 항목을 선택할 수 있습니다. 각 목록 항목에 확인란이 추가됩니다.
BOOLEAN
False
N
N
AutoSelectFirstRow
데이터 서비스가 로드될 때 첫 번째 데이터 행을 자동 선택합니다.
BOOLEAN
False
N
N
View
목록 유형(목록, 드롭다운, 콤보 상자 또는 라디오 버튼 목록)을 결정합니다. 콤보 상자를 사용하면 자동 완성 검색을 수행하여 목록의 범위를 좁힐 수 있습니다.
STRING
목록
N
N
WidthOfDropdownView
드롭다운 보기의 너비(픽셀)입니다. 위젯의 드롭다운 부분은 위젯보다 넓을 수 있습니다.
NUMBER
110
N
N
NumberOfItemsInDropdownView
드롭다운 보기에서 목록에 표시할 항목 수입니다.
NUMBER
6
N
N
NumberOfItemsPerPage
콤보 상자 목록 보기에 페이지별로 표시되는 항목 수를 설정할 수 있습니다.
쪽매김을 사용하지 않으려면 ≤ 0 값을 입력합니다.
NUMBER
500
N
N
TabSequence
탭 시퀀스의 위젯 색인입니다.
NUMBER
0
N
N
Alignment
위젯의 정렬(왼쪽 정렬, 오른쪽 정렬 또는 가운데 정렬)입니다.
STRING
왼쪽 정렬
N
N
LabelAlignment
레이블의 정렬(왼쪽, 오른쪽 또는 가운데)입니다.
STRING
왼쪽
N
N
Data
위젯의 데이터 소스입니다.
INFOTABLE
해당 없음
Y
N
DisplayField
표시할 데이터를 나타내는 인포테이블 필드입니다.
해당 없음
해당 없음
N
N
ValueField
값을 나타내는 인포테이블 필드입니다.
해당 없음
해당 없음
N
N
EnableKeyboardSelections
키보드 선택이 활성화되어 있습니다.
BOOLEAN
True
N
N
TextIfNoSelection
목록에서 아무 것도 선택되지 않은 경우 표시할 텍스트입니다.
STRING
해당 없음
N
Y
TextIfNoSelectionType
TextIfNoSelection 속성 필드에 입력된 텍스트가 매쉬업에서 자리 표시자 또는 편집 가능 텍스트로 나타나도록 설정합니다.
STRING
편집 가능
N
N
ClearIfNoSelection
아무 것도 선택되지 않은 경우 SelectedText를 지웁니다.
BOOLEAN
False
N
N
DisableSelectedStyle
선택한 콤보 항목에 적용되는 스타일을 비활성화합니다.
BOOLEAN
False
N
N
SelectedText
현재 선택된 인포테이블 필드 값입니다.
* 
콤보 상자 보기에는 SelectedText를 바인딩한 후 입력한 텍스트가 목록에 있는지 여부와 관계없이 입력한 텍스트가 표시됩니다.
* 
다른 모든 목록 보기에는 SelectedText를 바인딩한 후 현재 선택되고 목록에 있는 항목만 표시되며 입력한 다른 텍스트는 표시되지 않습니다.
STRING
해당 없음
Y
N
SelectedItems
현재 선택된 인포테이블 필드 값입니다.
* 
콤보 상자 보기에는 SelectedItems를 바인딩한 후 입력한 텍스트가 목록에 있는지 여부와 관계없이 입력한 텍스트가 표시됩니다.
* 
Multiselect 속성을 사용할 수 있는 다른 모든 목록 보기에는 SelectedItems를 바인딩한 후 현재 선택되고 목록에 있는 항목만 표시됩니다. 입력한 다른 텍스트는 표시되지 않습니다.
INFOTABLE
해당 없음
Y
N
ListBackgroundStyle
목록의 배경 스타일입니다.
STYLEDEFINITION
해당 없음
N
N
ListItemStyle
드롭다운 항목의 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ListItemAlternateStyle
드롭다운에서 대체 행의 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ListItemHoverStyle
드롭다운에서 항목의 가리키기 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ListItemSelectedStyle
드롭다운에서 선택한 항목의 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ListLabelStyle
콤보 상자 위에 표시되는 드롭다운 레이블의 텍스트 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ListFocusStyle
포커스에 있을 때 텍스트 상자 스타일입니다.
STYLEDEFINITION
해당 없음
N
N
ToolTipStyle
활성화 시 도구 설명 스타일입니다.
STYLEDEFINITION
해당 없음
N
N
DropdownButtonStyle
드롭다운 버튼의 스타일입니다.
STYLEDEFINITION
해당 없음
N
N
DropdownStyle
드롭다운 컨테이너의 스타일입니다.
STYLEDEFINITION
해당 없음
N
N
DropdownSelectedStyle
선택한 항목의 텍스트 색상 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ComboTextboxStyle
콤보 상자의 텍스트 상자 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ComboDropdownButtonStyle
콤보 상자의 드롭다운 아이콘 스타일을 지정합니다.
STYLEDEFINITION
해당 없음
N
N
ComboItemHighlightedStyle
콤보 항목이 강조 표시된 스타일입니다.
STYLEDEFINITION
해당 없음
N
N
RowHeight
실행 시간에 각 행의 높이입니다.
NUMBER
28
N
N
TextVerticalAlignment
행에서 텍스트의 세로 정렬을 사용합니다. 기본값은 30이며, 14px보다 작은 글꼴 크기에 적용됩니다. 더 큰 글꼴 크기의 경우 이 값을 큰 설정으로 조정하여 텍스트가 행에서 완전히 표시되도록 해야 합니다.
* 
브라우저에서 개발자 도구를 사용하여 목록 행에 대해 line height CSS 속성을 조정하여 텍스트를 적절하게 정렬하는 정확한 값을 설정합니다. 글꼴 크기가 11px인 경우 이 선 높이(line height) 설정은 약 30입니다. 가장 큰 글꼴 크기인 72px의 경우 선택한 행 높이에 맞게 정렬되도록 선 높이를 약 72~90으로 조정해야 합니다. 다양한 브라우저에서 글꼴 크기가 다르게 해석되므로 이러한 수동 조정이 필요할 수 있습니다. 입력한 값이 정확하지 않으면 텍스트 정렬이 적절하지 않을 수 있으며, 텍스트의 일부만 매쉬업에 표시될 수 있습니다.
NUMBER
30
N
N
DoubleClicked
이벤트입니다. DoubleClicked 이벤트를 사용할 경우 한 번 클릭하면 데이터 객체가 선택되고 두 번 클릭하면 탐색 링크를 트리거하는 등의 다른 이벤트가 발생하도록 설정할 수 있습니다.
해당 없음
해당 없음
Y
N
레이블
위젯에 표시할 레이블입니다.
STRING
해당 없음
Y
Y