Object List 위젯
Object List는 한 객체 유형 또는 여러 유형의 데이터를 목록이나 격자로 표시합니다. 속성, 연결 객체, 이미지와 아이콘을 함께 보여 주고 선택과 정렬 및 이벤트를 구성할 수 있습니다.
입력과 속성
Object set에 기존 변수를 연결하거나 위젯에서 새 집합을 만듭니다. 입력을 채운 뒤 속성과 다른 구성 옵션을 지정할 수 있습니다.
| 설정 | 동작 |
|---|---|
| Add media | 객체 정보 옆에 이미지나 아이콘을 추가합니다. |
| Add property | 목록에 표시할 속성을 고릅니다. |
| Default sort(s) | 기본 정렬을 하나까지 지정합니다. 표시한 속성뿐 아니라 숨긴 속성으로도 정렬할 수 있습니다. |
| Enable user sorting | 목록 위에 정렬을 바꾸는 subheader를 제공합니다. 사용자는 표시하거나 숨긴 속성으로 정렬할 수 있습니다. |
| Enable reordering | 항목을 드래그하여 순서를 바꾸는 기능을 구성합니다. 드래그는 카드 오른쪽의 handle로 시작합니다. |
| Hide null properties | 객체별로 null 속성을 숨겨 표시를 줄입니다. |
온톨로지에 구성한 숫자 및 조건부 서식도 사용할 수 있습니다.
선택
Active object는 현재 활성화하거나 강조한 행을 객체 하나의 집합으로 출력합니다. Enable active object auto-selection은 기본적으로 첫 행을 자동 선택합니다. 자동 선택을 끄면 초기 Active object가 비어 있습니다.
Enable multi-select를 켜면 여러 항목을 체크하고 Selected objects로 출력할 수 있습니다. 이 출력은 multi-select를 켠 경우에만 값을 채웁니다. On active object selection에는 상세 drawer를 여는 등의 이벤트를 연결합니다.
표시
| 설정 | 동작 |
|---|---|
| Title | 입력한 문자열을 subheader에 표시합니다. |
| Show security markings | 속성 보안 표지를 회색 배지로 표시하고 선택하면 상세 창을 엽니다. |
| Show object count | 입력 객체 집합의 개수를 subheader에 표시합니다. |
| Widget display | 기본 List 또는 Grid를 고릅니다. Grid에서는 행 수, 객체 카드 크기와 간격을 정할 수 있습니다. |
| Property style | 기본적으로 속성 이름과 값을 inline으로 표시하며, 값이 정렬되도록 배치하는 방식도 선택할 수 있습니다. |
| Empty state message | 표시할 객체가 없을 때의 문구를 정합니다. |
미디어
Property에는 이미지 URL, 이미지 첨부 파일 또는 미디어 참조 속성을 지정할 수 있습니다. Media display는 큰 이미지 또는 객체 제목 옆의 온톨로지 아이콘을 대체하는 아이콘을 선택합니다.
Enable expanded image preview는 modal에서 전체 이미지를 볼 수 있게 합니다. Show properties on image hover는 이미지 위에 포인터를 올렸을 때 추가 속성을 overlay로 보여 줍니다.
Image position에서 위치와 고정 높이 또는 너비를 정합니다. Resizing은 영역을 채우도록 자르거나, 잘리지 않은 전체 이미지가 컨테이너 안에 들어오게 맞추는 방식입니다.
재정렬
재정렬은 하나의 Object List 안에서만 지원합니다. Grid에서는 지원하지 않으며, 켠 경우 처음 500개 객체만 표시합니다.
Conditionally enabled에 Boolean 변수를 연결하여 재정렬 가능 여부를 정할 수 있습니다. Primary key array에는 표시 객체들의 기본 키를 String Array로 제공합니다. 배열의 순서대로 정렬 영역에 표시합니다.
Unsorted list
배열에 키가 없는 객체는 정렬된 영역 아래 Unsorted list에 표시합니다. 기본 정렬이 있으면 적용하고 없으면 별도 정렬 없이 표시합니다.
Unsorted list에서 위로 끌어오면 키를 배열에 추가하고 그 영역으로 다시 옮기면 배열에서 제거합니다. 배열이 비었거나 표시 객체와 겹치는 키가 없으면 Drag and drop unsorted items above to sort라는 안내를 보여 줍니다.
필터로 보이지 않는 객체의 키도 배열 안에서 유지합니다. 가령 배열이 [A, B, C, D]이고 B가 숨겨졌다면 화면은 [A, C, D]입니다. D를 A와 C 사이로 옮기면 배열은 [A, B, D, C]가 됩니다. 다만 마지막으로 보이는 객체 아래에 항목을 놓으면 그 마지막 객체 바로 뒤에 넣습니다.
순서 변경 후 동작
| On reorder 선택 | 동작 |
|---|---|
| Update array variable | 사용자가 순서를 바꾸면 기본 키 배열 변수를 갱신합니다. |
| Submit an action | 재정렬할 때마다 지정한 Reorder action을 실행합니다. Reordered array라는 특수 매개변수 값으로 갱신된 배열을 전달하여 저장할 수 있습니다. |
배열 변수만 바꾸면 자동으로 영구 저장하지 않습니다. 새로고침하거나 모듈을 떠나면 변경을 잃을 수 있습니다. 업무 데이터로 순서를 보관하려면 배열을 저장하는 액션을 구성합니다. 매번 액션을 실행하고 싶지 않다면 Update array variable로 모은 뒤 별도의 Button Group에서 저장 액션을 실행할 수 있습니다.
여러 열의 비교와 셀 편집은 Object Table, 상세 정보는 Object View 또는 Property List로 연결합니다.