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.
tajuk
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.