목록 템플릿

목록 템플릿은 세로로 스크롤되는 또는 대화 항목 컬렉션을 표시합니다. 목록은 사용자가 최근에 탐색한 장소나 대기열에 있는 노래와 같이 텍스트 형식으로 항목을 빠르게 탐색해야 할 때 유용합니다.

목록 템플릿을 사용하면 다음 작업을 할 수 있습니다.

  • 로드 상태를 나타냅니다.
  • 하위 목록을 사용하여 목록을 섹션으로 구분합니다.
  • 을 스위치 또는 라디오 버튼으로 사용합니다.

탭 템플릿에 목록을 삽입하여 탭 탐색을 제공하고 지도 + 콘텐츠 템플릿을 사용하여 지도에 목록을 표시할 수도 있습니다.

목록 템플릿
섹션이 있는 목록 템플릿
지도에 있는 목록 템플릿

포함 항목:

  • 선택사항 헤더: 이 템플릿이 탭 템플릿에 삽입되면 헤더가 탭으로 대체됩니다.
  • 목록 항목 (항목 수와 행의 텍스트 양이 다를 수 있음):
    • 목록 항목 수입니다. 표시할 수 있는 항목 수는 차량에 따라 다릅니다. 특정 차량의 목록 행 제한을 가져오려면 ConstraintManager API를 사용하세요.
    • 상품당 텍스트 양 목록 행의 보조 텍스트는 주차 시 2행보다 길어질 수 있습니다. 주차 중 목록 텍스트 더보기를 참고하세요.
  • 선택사항인 플로팅 작업 버튼

목록 템플릿의 행으로 할 수 있는 작업에 대해 자세히 알아보려면 목록 템플릿 전용 행 옵션샘플 흐름의 예시를 참고하세요.

주차 시 더 많은 목록 텍스트

각 목록 행에 허용되는 보조 텍스트의 양은 자동차가 주차되어 있는지 아니면 운전 중인지에 따라 다릅니다. 운전 중에는 주의를 산만하게 하는 요소를 최소화하기 위해 텍스트가 두 줄로 잘립니다. 운전 중에 읽을 텍스트는 보조 텍스트의 시작 부분에 표시해야 합니다.

운전 중
주차됨

목록 템플릿 UX 요구사항

필수(MUST) 섹션이 있는 경우 섹션 헤더를 포함합니다.
해서는 안 되는 작업(MUST NOT) 선택 가능한 목록 행 (라디오 버튼이 있는 행)을 다른 유형의 행과 혼합하거나 섹션으로 구분합니다.
해야 하는 작업(SHOULD) 선택 가능한 목록에 기본 선택사항을 표시합니다.
해야 하는 작업(SHOULD) 각 목록 항목과 연결된 작업이 있어야 합니다 (정보 전용 행은 권장되지 않음).
해야 하는 작업(SHOULD) 운전 중에 읽을 수 있는 보조 텍스트의 콘텐츠를 잘리지 않도록 시작 부분 근처에 배치합니다.
해야 하는 작업(SHOULD) 선택적 제목과 기본 및 보조 작업이 있는 헤더를 포함합니다.
가능(MAY) 목록 콘텐츠를 섹션으로 나눕니다.
가능(MAY) 필요에 따라 전환 스위치가 있는 행을 다른 행과 혼합합니다.
가능(MAY) 사용자가 전환 버튼 상태를 변경하면 행 텍스트와 이미지 또는 아이콘 애셋을 업데이트합니다.

리소스

유형 링크
API 참조 ListTemplate, ListTemplate.Builder