오브젝트 목록

오브젝트 목록 위젯은 오브젝트 데이터를 목록 또는 그리드로 표시하는 데 사용됩니다. 모듈 빌더가 오브젝트 목록 위젯을 구성할 때:

하나 이상의 오브젝트 유형의 데이터를 표시할 수 있습니다.
어떤 속성 유형과 연결된 오브젝트가 표시되고 어떤 형식으로 표시되는지 선택할 수 있습니다.
각 오브젝트에 대한 이미지 또는 아이콘을 표시하기 위해 미디어 속성을 선택적으로 사용할 수 있습니다.
초기 정렬 기준을 설정할 수 있습니다.
Ontology Manager에서 구성된 조건적 포맷팅 및 숫자 포맷팅 옵션을 표시할 수 있습니다.
오브젝트별로 null 속성을 숨겨 더 간결한 표시를 만들 수 있습니다.
목록 내에서 단일 또는 다중 선택을 허용할 수 있습니다.
목록 내 오브젝트 선택에 따라 Workshop 이벤트를 트리거할 수 있습니다.

아래 스크린샷은 구성된 오브젝트 목록 위젯에서 Flight Alert 오브젝트를 표시하는 예를 보여줍니다:

object_list_example

아래 스크린샷은 이미지가 있는 그리드 디스플레이로 구성된 오브젝트를 표시하는 오브젝트 목록 위젯의 예를 보여줍니다:

object_list_image_example

아래 스크린샷은 아이콘이 있는 목록 디스플레이로 구성된 오브젝트를 표시하는 오브젝트 목록 위젯의 예를 보여줍니다:

object_list_icon_example

구성 옵션

아래는 새롭게 추가된 오브젝트 목록 위젯의 초기 상태와 초기 구성 패널의 스크린샷입니다:

object_list_empty_state

오브젝트 목록 위젯의 핵심 구성 옵션은 다음과 같습니다:

입력값 데이터
- 오브젝트 세트: 이 입력 변수는 위젯 내에 표시될 데이터를 결정합니다. 모듈 빌더는 이 모듈에서 다른 곳에서 생성된 기존 오브젝트 세트 변수를 재사용하거나 새 오브젝트 세트 변수를 인라인으로 정의할 수 있습니다. 이 오브젝트 세트 매개변수가 채워지면 아래에 표시된 다른 구성 옵션 중 일부만 구성 가능합니다.
속성 구성
- 미디어 추가: 오브젝트 정보와 함께 이미지를 선택적으로 표시할 수 있습니다. 아래에 있는 미디어 구성 옵션에 대한 자세한 정보를 참조하세요.
- 속성 추가: 여기서 속성을 선택하면 해당 속성이 목록에 표시됩니다.
- 기본 정렬: 이 설정을 사용하면 목록 내에서 최대 한 개의 기본 정렬을 적용할 수 있습니다. 모듈 빌더는 목록에 표시된 표시되는 속성 유형이나 숨겨진 속성 유형에 대해 정렬할 수 있습니다.
- 사용자 정렬 활성화: 활성화되면 사용자가 목록의 정렬 기준을 변경할 수 있는 하위 헤더가 목록 위에 표시됩니다. 사용자는 목록에 표시된 표시되는 속성 유형이나 숨겨진 속성 유형에 대해 정렬할 수 있습니다.
- null 속성 숨기기: 활성화하면 목록에서 오브젝트별로 null 속성이 숨겨집니다.
선택
- 활성 오브젝트: 이 위젯의 첫 번째 출력 변수로 현재 활성/강조된 행의 싱글톤 오브젝트 세트를 출력합니다. 이 오브젝트 세트는 현재 모듈의 하위 위젯에서 사용할 수 있습니다.
- 활성 오브젝트 자동 선택 활성화: 기본적으로 목록의 첫 번째 행이 로드 시 활성 오브젝트로 자동 설정됩니다. 이 설정을 비활성화하면 로드 시 빈 활성 오브젝트가 생성됩니다.
- 선택된 오브젝트: 이 위젯의 두 번째 출력 변수로 현재 체크된/선택된 행의 오브젝트 세트를 출력합니다. 이 오브젝트 세트는 현재 모듈의 하위 위젯에서 사용할 수 있습니다. 이 출력 변수는 다중 선택 활성화 토글이 참으로 설정되어 있는 경우에만 사용되고 채워집니다.
- 활성 오브젝트 선택 시: 이 옵션을 사용하면 모듈 빌더가 목록에서 행이 선택될 때 트리거되는 Workshop 이벤트를 구성할 수 있습니다. 이를 통해 더 자세한 Object View를 표시하는 서랍이 나타나게 할 수 있습니다.
- 다중 선택 활성화: 활성화하면 사용자가 목록에서 여러 오브젝트를 체크/선택할 수 있습니다. 이 선택된 오브젝트 세트는 현재 모듈의 하위 위젯에서 사용할 수 있는 선택된 오브젝트 오브젝트 세트를 통해 출력됩니다.
디스플레이 및 포맷팅
- 제목: 채워져 있는 경우, 여기에 입력된 문자열 제목과 함께 목록 위에 하위 헤더가 표시됩니다.
- 오브젝트 개수 표시: 활성화하면 입력 오브젝트 세트 변수에 포함된 오브젝트 개수를 표시하는 하위 헤더가 목록 위에 표시됩니다.
- 위젯 디스플레이: 기본적으로 오브젝트를 목록으로 표시하지만, 그리드에서 오브젝트를 표시하고 그리드의 행 수, 각 오브젝트 카드 크기 및 그리드의 카드 간격을 지정할 수도 있습니다.
- 속성 스타일: 기본적으로 속성이 값과 함께 인라인으로 표시되지만, 값과 정렬되어 표시할 수도 있습니다.
- 빈 상태 메시지: 이 위젯에 표시할 오브젝트가 없을 때 빈 상태 메시지를 사용자 정의할 수 있습니다.

미디어 구성 옵션

object_list_media_config

오브젝트 목록 위젯의 미디어 구성 옵션은 다음과 같습니다:

속성: 오브젝트 세트의 이미지를 포함하는 속성입니다. 현재 이미지 URL, 이미지 첨부 파일 및 미디어 참조 속성이 지원됩니다.
미디어 디스플레이: 선택한 미디어는 큰 이미지로 표시되거나, 오브젝트 제목 옆에 온톨로지 아이콘을 대체하는 아이콘으로 표시할 수 있습니다.
확장된 이미지 미리보기 활성화: 활성화하면 이미지를 확장하여 모달 내에서 전체 크기로 볼 수 있습니다.
이미지 위에 마우스를 올렸을 때 속성 표시: 활성화하면 이미지 위에 추가 속성이 오버레이로 표시됩니다.
이미지 위치: 이미지는 다양한 위치에 표시할 수 있으며, 높이나 너비를 고정 크기로 조절할 수 있습니다.
크기 조절: 이미지는 공간을 채우기 위해 자르거나, 컨테이너에 맞게 조절하여 자르지 않고 완전한 이미지를 표시할 수 있습니다.