CarUiListItem

이 도움말에서는 CarUiListItem 목록 항목의 맞춤설정 옵션을 자세히 설명합니다.

자동차 UI 라이브러리를 사용하여 항목 목록을 표시하는 데 허용되는 패러다임은 CarUiRecyclerView를 CarUiListItemAdapter 및 CarUiListItem 객체와 함께 사용하는 것입니다. CarUiRecyclerView 맞춤설정은 caruirecyclerview에서 다룹니다.

기본 요건

다음 콘텐츠는 앱 맞춤설정에서 설명한 런타임 리소스 오버레이(RRO)를 파악했다고 가정합니다.

CarUiListItem 정보

목록 항목은 두 가지 상위 수준 유형인 헤더나 콘텐츠 중 하나일 수 있습니다. 각 유형은 아래에 설명되어 있습니다.

CarUiListItemAdapter는 CarUiHeaderListItem 유형의 객체를 다음 뷰가 포함된 car_ui_header_list_item 레이아웃 파일에서 확장된 뷰에 바인딩합니다.

조회수
title 제목 TextView.
body 본문 TextView.

예를 들어 아래의 헤더 목록 항목은 제목 및 본문 텍스트를 표시하도록 구성됩니다.

콘텐츠

CarUiListItemAdapter는 CarUiHeaderListItem 유형의 객체를 car_ui_list_item 레이아웃 파일에서 확장된 뷰에 바인딩합니다. 이 파일에는 다음 뷰가 포함되어 있습니다.

조회수
icon_container 기본 아이콘의 컨테이너
title 제목 TextView.
body 본문 TextView.
action_container 작업 뷰의 컨테이너

예를 들어 아래의 콘텐츠 목록 항목은 아이콘 및 스위치를 표시하도록 구성되었습니다.

아이콘

목록 항목에 구성된 아이콘 유형에 따라 다음 세 가지 뷰 중 하나가 기본 아이콘에 사용됩니다.

조회수
icon 표준 아이콘 ImageView.
content_icon 콘텐츠 아이콘 ImageView.
avatar_icon 아바타 아이콘 ImageView.

작업 요소

목록 항목의 작업 유형에 따라 다음 작업 요소 뷰 중 최대 하나가 표시됩니다.

조회수
switch_widget Switch
checkbox_widget CheckBox
radio_button_widget RadioButton
supplemental_icon ImageView

텍스트 맞춤설정

헤더와 콘텐츠 목록 항목에서 모두 텍스트 스타일 지정은 자동차 UI 라이브러리에서 정의된 텍스트 모양 스타일로 제어됩니다. 목록 항목의 텍스트 스타일을 재정의하려면 아래에 나열된 상응하는 스타일을 재정의합니다.

헤더 스타일을 맞춤설정하는 방법은 다음과 같습니다.

헤더 스타일
제목 텍스트 @style/TextAppearance.CarUi.ListItem
본문 텍스트 @style/TextAppearance.CarUi.ListItem.Body

콘텐츠 스타일을 맞춤설정하는 방법은 다음과 같습니다.

콘텐츠 스타일
제목 텍스트 @style/TextAppearance.CarUi.ListItem.Header
본문 텍스트 @style/TextAppearance.CarUi.ListItem.Body

아이콘 맞춤설정

콘텐츠 목록 항목에는 기본 및 보조 아이콘이 모두 포함될 수 있습니다.

기본 아이콘

콘텐츠 목록 항목 레이아웃의 아이콘 컨테이너 내에는 정의된 ImageView 객체가 세 개 있지만 목록 항목의 지정된 아이콘 유형에 따라 아이콘은 최대 1개가 표시됩니다. 항목 바인딩 시간에 CarUiListItemAdapter는 아이콘 ImageView 객체의 적절한 공개 상태를 설정합니다.

아이콘의 너비와 높이는 크기 조절을 위해 오버레이될 수 있는 크기 값으로 제어됩니다. 다양한 아이콘 유형의 너비와 높이를 지정하는 크기 값이 아래에 나열되어 있습니다.

표준 아이콘

기본적으로 표준 아이콘의 높이와 너비는 동일합니다.

표준 아이콘
너비 car_ui_list_item_icon_size
높이 car_ui_list_item_icon_size

콘텐츠 아이콘

콘텐츠 아이콘
너비 car_ui_list_item_content_icon_width
높이 car_ui_list_item_content_icon_height

아바타 아이콘

기본 아이콘은 너비가 car_ui_list_item_icon_container_width 크기 값으로 정의된 아이콘 컨테이너 뷰 내에서 기본적으로 중앙에 위치합니다.

아바타 아이콘
너비 car_ui_list_item_content_icon_width
높이 car_ui_list_item_content_icon_height

보조 아이콘

보조 아이콘은 작업 컨테이너 뷰 내에서 중앙에 위치합니다. 보조 아이콘의 너비와 높이는 car_ui_list_item_supplemental_icon_size 크기 값으로 정의됩니다. 이 크기 값을 오버레이하여 보조 아이콘의 크기를 변경합니다.