Các lựa chọn tuỳ chỉnh cho CarUiListItem

Trang này trình bày chi tiết các tuỳ chọn tuỳ chỉnh cho các mục danh sách CarUiListItem.

Mô hình được chấp nhận để sử dụng thư viện Giao diện người dùng trên ô tô nhằm 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. Nội dung tuỳ chỉnh CarUiRecyclerView được đề cập trong caruirecyclerview.

Điều kiện tiên quyết

Nội dung sau đây giả định bạn đã hiểu về lớp phủ tài nguyên thời gian chạy (RRO) được mô tả trong phần Tuỳ chỉnh ứng dụng.

Giới thiệu về CarUiListItem

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 loại sẽ được mô tả bên dưới.

CarUiListItemAdapter liên kết các đối tượng thuộc loại CarUiHeaderListItem với một thành phần hiển thị được tăng cường từ tệp bố cục car_ui_header_list_item, chứa các thành phần hiển thị sau:

Số lượt xem
title Tiêu đề TextView
body Body TextView

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à văn bản nội dung:

Nội dung

CarUiListItemAdapter liên kết các đối tượng thuộc loại CarUiHeaderListItem với một thành phần hiển thị được tăng cường từ tệp bố cục car_ui_list_item. Tệp này chứa các thành phần hiển thị sau:

Số lượt xem
icon_container Vùng chứa cho biểu tượng chính
title Tiêu đề TextView
body Body TextView
action_container Vùng chứa cho thành phần hiển thị thao tác

Ví dụ: mục danh sách nội dung bên dưới được định cấu hình để hiển thị một biểu tượng và một nút chuyển:

Biểu tượng

Tuỳ 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 đây sẽ được dùng cho biểu tượng chính:

Số lượt xem
icon ImageView biểu tượng chuẩn
content_icon Biểu tượng nội dung ImageView
avatar_icon Biểu tượng hình đại diện ImageView

Phần tử hành động

Hệ thống sẽ hiển thị tối đa một trong các thành phần hiển thị thành phần hành động sau đây, dựa trên loại hành động cho mục danh sách:

Số lượt xem
switch_widget Switch
checkbox_widget CheckBox
radio_button_widget RadioButton
supplemental_icon ImageView

Tuỳ chỉnh văn bản

Kiểu văn bản trong cả tiêu đề và mục danh sách nội dung được kiểm soát bằng các kiểu giao diện văn bản được xác định trong thư viện Giao diện người dùng ô tô. Để ghi đè kiểu văn bản của các mục trong danh sách, hãy ghi đè các kiểu tương ứng được liệt kê bên dưới.

Cách tuỳ chỉnh kiểu tiêu đề:

Kiểu tiêu đề
Văn bản tiêu đề @style/TextAppearance.CarUi.ListItem
Văn bản chính @style/TextAppearance.CarUi.ListItem.Body

Cách tuỳ chỉnh kiểu nội dung:

Kiểu nội dung
Văn bản tiêu đề @style/TextAppearance.CarUi.ListItem.Header
Văn bản chính @style/TextAppearance.CarUi.ListItem.Body

Tuỳ chỉnh biểu tượng

Các mục trong 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 nhiều nhất chỉ có một biểu tượng được hiển thị dựa trên loại biểu tượng đã chỉ định của mục danh sách. Tại thời điểm liên kết mục, CarUiListItemAdapter sẽ đặt chế độ 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ằng các giá trị kích thước có thể được phủ lên để kiểm soát kích thước. Dưới đây là danh sách các giá trị kích thước chỉ định chiều rộng và chiều cao cho nhiều loại biểu tượng.

Biểu tượng chuẩn

Theo mặc định, các biểu tượng 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 khung hiển thị vùng chứa biểu tượng, có chiều rộng được xác định bằng giá trị kích thước 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 đặt ở giữa chế độ xem vùng chứa thao tác. Cả chiều rộng và chiều cao của biểu tượng bổ sung đều được xác định bằng giá trị kích thước car_ui_list_item_supplemental_icon_size. Lớp phủ giá trị phương diện này để thay đổi kích thước của biểu tượng bổ sung.