Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

MobilUiListItem

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Artikel ini merinci opsi penyesuaian untuk item daftar CarUiListItem .

Paradigma yang diterima untuk menggunakan perpustakaan UI Mobil untuk menampilkan daftar item adalah dengan menggunakan CarUiRecyclerView bersama dengan objek CarUiListItemAdapter dan CarUiListItem . CarUiRecyclerView tercakup dalam caruirecyclerview .

Prasyarat

Konten berikut mengasumsikan pemahaman tentang Runtime Resource Overlay (RRO) yang dijelaskan dalam Menyesuaikan Aplikasi .

Tentang CarUiListItem

Item daftar dapat berupa salah satu dari dua jenis tingkat tinggi, header atau konten . Masing-masing dijelaskan di bawah ini.

CarUiListItemAdapter mengikat objek bertipe CarUiHeaderListItem ke tampilan yang diperluas dari file tata letak car_ui_header_list_item , yang berisi tampilan berikut:

Tampilan
title Judul TextView.
body Tampilan Teks Tubuh.

Misalnya, item daftar header di bawah ini dikonfigurasi untuk menampilkan judul dan teks isi:

Isi

CarUiListItemAdapter mengikat objek bertipe CarUiHeaderListItem ke tampilan yang diperluas dari file tata letak car_ui_list_item . File ini berisi tampilan berikut:

Tampilan
icon_container Wadah untuk ikon utama.
title Judul TextView.
body Tampilan Teks Tubuh.
action_container Wadah untuk tampilan tindakan.

Misalnya, item daftar konten di bawah ini dikonfigurasi untuk menampilkan ikon dan sakelar:

ikon

Tergantung pada jenis ikon yang dikonfigurasi untuk item daftar, salah satu dari tiga tampilan berikut digunakan untuk ikon utama:

Tampilan
icon Ikon standar ImageView.
content_icon Ikon konten ImageView.
avatar_icon Ikon Avatar ImageView.

elemen tindakan

Paling banyak, salah satu tampilan elemen tindakan berikut ditampilkan, berdasarkan tipe tindakan untuk item daftar:

Tampilan
switch_widget Switch
checkbox_widget CheckBox
radio_button_widget RadioButton
supplemental_icon ImageView

Sesuaikan teks

Gaya teks di item header dan daftar konten dikontrol oleh gaya tampilan teks yang ditentukan di pustaka UI Mobil. Untuk mengganti gaya teks item daftar, timpa gaya terkait yang tercantum di bawah ini.

Untuk menyesuaikan gaya tajuk :

Gaya Tajuk
teks judul @style/TextAppearance.CarUi.ListItem
teks isi @style/TextAppearance.CarUi.ListItem.Body

Untuk menyesuaikan gaya konten :

Gaya Konten
teks judul @style/TextAppearance.CarUi.ListItem.Header
teks isi @style/TextAppearance.CarUi.ListItem.Body

Sesuaikan ikon

Item daftar konten dapat berisi ikon utama dan tambahan.

Ikon utama

Meskipun ada tiga objek ImageView yang ditentukan dalam wadah ikon dalam tata letak item daftar konten, paling banyak satu ikon ditampilkan berdasarkan jenis ikon item daftar yang ditentukan. Pada waktu pengikatan item, CarUiListItemAdapter menyetel visibilitas yang sesuai untuk objek ikon ImageView.

Lebar dan tinggi ikon dikontrol oleh nilai dimensi yang dapat dilapis untuk mengontrol ukuran. Nilai dimensi yang menentukan lebar dan tinggi untuk berbagai jenis ikon tercantum di bawah ini.

Ikon standar

Secara default, ikon standar memiliki tinggi dan lebar yang sama.

Ikon Standar
Lebar car_ui_list_item_icon_size
Tinggi car_ui_list_item_icon_size

ikon konten

Ikon Konten
Lebar car_ui_list_item_content_icon_width
Tinggi car_ui_list_item_content_icon_height

ikon avatar

Secara default, ikon utama dipusatkan dalam tampilan wadah ikon, yang lebarnya ditentukan oleh nilai dimensi car_ui_list_item_icon_container_width .

Ikon Avatar
Lebar car_ui_list_item_content_icon_width
Tinggi car_ui_list_item_content_icon_height

Ikon tambahan

Ikon tambahan dipusatkan dalam tampilan wadah tindakan. Baik lebar dan tinggi ikon tambahan ditentukan oleh nilai dimensi car_ui_list_item_supplemental_icon_size . Hamparkan nilai dimensi ini untuk mengubah ukuran ikon tambahan.