이 페이지에서는 CarUiListItem 목록 항목에 대한 사용자 정의 옵션을 자세히 설명합니다.
Car UI 라이브러리를 사용하여 항목 목록을 표시하는 데 허용되는 패러다임은 CarUiListItemAdapter 및 CarUiListItem 개체와 함께 CarUiRecyclerView 사용하는 것입니다. CarUiRecyclerView 사용자 정의는 caruirecyclerview 에서 다룹니다.
전제조건
다음 콘텐츠에서는 앱 사용자 정의 에 설명된 RRO(런타임 리소스 오버레이)를 이해하고 있다고 가정합니다.
CarUiListItem 정보
목록 항목은 두 가지 상위 수준 유형( header 또는 content ) 중 하나일 수 있습니다. 각각은 아래에 설명되어 있습니다.
머리글
CarUiListItemAdapter CarUiHeaderListItem 유형의 객체를 다음 뷰가 포함된 car_ui_header_list_item 레이아웃 파일에서 확장된 뷰에 바인딩합니다.
| 견해 | |
|---|---|
title | 제목 텍스트뷰 |
body | 본문 텍스트 보기 |
예를 들어 아래 헤더 목록 항목은 제목 과 본문 텍스트를 표시하도록 구성됩니다.
콘텐츠
CarUiListItemAdapter CarUiHeaderListItem 유형의 객체를 car_ui_list_item 레이아웃 파일에서 확장된 뷰에 바인딩합니다. 이 파일에는 다음 보기가 포함되어 있습니다.
| 견해 | |
|---|---|
icon_container | 기본 아이콘의 컨테이너 |
title | 제목 텍스트뷰 |
body | 본문 텍스트 보기 |
action_container | 작업 뷰용 컨테이너 |
예를 들어 아래 콘텐츠 목록 항목은 아이콘 과 스위치를 표시하도록 구성되었습니다.
아이콘
목록 항목에 구성된 아이콘 유형에 따라 다음 세 가지 보기 중 하나가 기본 아이콘에 사용됩니다.
| 견해 | |
|---|---|
icon | 표준 아이콘 이미지 보기 |
content_icon | 콘텐츠 아이콘 이미지 보기 |
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 개체가 정의되어 있지만 목록 항목의 지정된 아이콘 유형에 따라 최대 하나의 아이콘이 표시됩니다. 항목 바인딩 시 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 치수 값으로 정의됩니다. 보조 아이콘의 크기를 변경하려면 이 치수 값을 오버레이하세요.