Trang này nêu chi tiết các tùy chọn tùy chỉnh cho các mục trong danh sách CarUiListItem .
Mô hình được chấp nhận khi sử dụng thư viện Car UI để hiển thị danh sách các mục là sử dụng CarUiRecyclerView kết hợp với các đối tượng CarUiListItemAdapter và CarUiListItem . Tùy chỉnh CarUiRecyclerView được đề cập trong caruirecyclerview .
Điều kiện tiên quyết
Nội dung sau đây giả định sự hiểu biết về lớp phủ tài nguyên thời gian chạy (RRO) được mô tả trong Tùy chỉnh ứng dụng .
Giới thiệu về CarUiListItem
Các mục danh sách có thể là một trong hai loại cấp cao, tiêu đề hoặc nội dung . Mỗi cái được mô tả dưới đây.
tiêu đề
CarUiListItemAdapter liên kết các đối tượng thuộc loại CarUiHeaderListItem với một chế độ xem được tăng cường từ tệp bố cục car_ui_header_list_item , chứa các chế độ xem sau:
| Lượt xem | |
|---|---|
title | Chế độ xem văn bản tiêu đề |
body | Chế độ xem văn bản nội dung |
Ví dụ: mục danh sách tiêu đề bên dưới được định cấu hình để hiển thị tiêu đề và nội dung:
Nội dung
CarUiListItemAdapter liên kết các đối tượng thuộc loại CarUiHeaderListItem với chế độ xem tăng cường từ tệp bố cục car_ui_list_item . Tệp này chứa các chế độ xem sau:
| Lượt xem | |
|---|---|
icon_container | Vùng chứa biểu tượng chính |
title | Chế độ xem văn bản tiêu đề |
body | Chế độ xem văn bản nội dung |
action_container | Vùng chứa cho chế độ xem hành động |
Ví dụ: mục danh sách nội dung bên dưới được định cấu hình để hiển thị biểu tượng và nút chuyển:
Biểu tượng
Tùy thuộc vào loại biểu tượng được định cấu hình cho mục danh sách, một trong ba chế độ xem sau được sử dụng cho biểu tượng chính:
| Lượt xem | |
|---|---|
icon | Biểu tượng tiêu chuẩn ImageView |
content_icon | Biểu tượng nội dung ImageView |
avatar_icon | Biểu tượng hình đại diện ImageView |
Yếu tố hành động
Nhiều nhất, một trong các chế độ xem thành phần hành động sau được hiển thị, dựa trên loại hành động cho mục danh sách:
| Lượt xem | |
|---|---|
switch_widget | Switch |
checkbox_widget | CheckBox |
radio_button_widget | RadioButton |
supplemental_icon | ImageView |
Tùy chỉnh văn bản
Kiểu văn bản trong cả mục danh sách tiêu đề và nội dung đều được kiểm soát bởi các kiểu hiển thị văn bản được xác định trong thư viện Car UI. Để ghi đè kiểu văn bản của các mục danh sách, hãy ghi đè các kiểu tương ứng được liệt kê bên dưới.
Để tùy chỉnh kiểu tiêu đề :
| Kiểu tiêu đề | |
|---|---|
| Tiêu đề văn bản | @style/TextAppearance.CarUi.ListItem |
| Bài kiểm tra cơ thể | @style/TextAppearance.CarUi.ListItem.Body |
Để tùy chỉnh kiểu nội dung :
| Phong cách nội dung | |
|---|---|
| Tiêu đề văn bản | @style/TextAppearance.CarUi.ListItem.Header |
| Bài kiểm tra cơ thể | @style/TextAppearance.CarUi.ListItem.Body |
Tùy chỉnh biểu tượng
Các mục danh sách nội dung có thể chứa cả biểu tượng chính và biểu tượng bổ sung.
Biểu tượng chính
Mặc dù có ba đối tượng ImageView được xác định trong vùng chứa biểu tượng trong bố cục mục danh sách nội dung, nhưng tối đa một biểu tượng được hiển thị dựa trên loại biểu tượng được chỉ định của mục danh sách. Tại thời điểm liên kết mục, CarUiListItemAdapter đặt mức độ hiển thị thích hợp cho các đối tượng ImageView biểu tượng.
Chiều rộng và chiều cao của biểu tượng được kiểm soát bởi các giá trị kích thước có thể được phủ lên để kiểm soát kích thước. Các giá trị thứ nguyên chỉ định chiều rộng và chiều cao cho các loại biểu tượng khác nhau được liệt kê bên dưới.
Biểu tượng chuẩn
Theo mặc định, các biểu tượng tiêu chuẩn có chiều cao và chiều rộng bằng nhau.
| Biểu tượng chuẩn | |
|---|---|
| Chiều rộng | car_ui_list_item_icon_size |
| Chiều cao | car_ui_list_item_icon_size |
Biểu tượng nội dung
| Biểu tượng nội dung | |
|---|---|
| Chiều rộng | car_ui_list_item_content_icon_width |
| Chiều cao | car_ui_list_item_content_icon_height |
Biểu tượng hình đại diện
Theo mặc định, các biểu tượng chính được căn giữa trong chế độ xem vùng chứa biểu tượng, có chiều rộng được xác định bởi giá trị thứ nguyên car_ui_list_item_icon_container_width .
| Biểu tượng hình đại diện | |
|---|---|
| Chiều rộng | car_ui_list_item_content_icon_width |
| Chiều cao | car_ui_list_item_content_icon_height |
Biểu tượng bổ sung
Biểu tượng bổ sung được căn giữa trong chế độ xem vùng chứa hành động. Cả chiều rộng và chiều cao của biểu tượng bổ sung đều được xác định bởi giá trị thứ nguyên car_ui_list_item_supplemental_icon_size . Xếp chồng giá trị thứ nguyên này để thay đổi kích thước của biểu tượng bổ sung.