หน้านี้จะแสดงรายละเอียดตัวเลือกการปรับแต่งสำหรับรายการในรายการ CarUiListItem
รูปแบบที่ยอมรับสำหรับการใช้ไลบรารี UI ของรถเพื่อแสดงรายการคือการใช้ CarUiRecyclerView ร่วมกับออบเจ็กต์ CarUiListItemAdapter และ CarUiListItem
การปรับแต่ง CarUiRecyclerView อยู่ใน
caruirecyclerview
สิ่งที่ต้องมีก่อน
เนื้อหาต่อไปนี้จะถือว่าคุณเข้าใจการซ้อนทับทรัพยากรรันไทม์ (RRO) ที่อธิบายไว้ในปรับแต่งแอป
เกี่ยวกับ CarUiListItem
รายการในลิสต์อาจเป็นประเภทระดับสูงอย่างใดอย่างหนึ่ง ได้แก่ ส่วนหัวหรือเนื้อหา แต่ละรายการมีคำอธิบายอยู่ด้านล่าง
ส่วนหัว
CarUiListItemAdapter จะเชื่อมโยงออบเจ็กต์ประเภท CarUiHeaderListItem กับมุมมองที่ขยายจากไฟล์เลย์เอาต์ car_ui_header_list_item ซึ่งมีมุมมองต่อไปนี้
| ยอดดู | |
|---|---|
title |
TextView ของชื่อ |
body |
TextView ของเนื้อหา |
ตัวอย่างเช่น รายการลิสต์ส่วนหัวด้านล่างได้รับการกําหนดค่าให้แสดงชื่อและข้อความเนื้อหา
เนื้อหา
CarUiListItemAdapter เชื่อมโยงออบเจ็กต์ประเภท CarUiHeaderListItem
กับมุมมองที่ขยายจากไฟล์เลย์เอาต์ car_ui_list_item ไฟล์นี้มีมุมมองต่อไปนี้
| ยอดดู | |
|---|---|
icon_container |
คอนเทนเนอร์สำหรับไอคอนหลัก |
title |
TextView ของชื่อ |
body |
TextView ของเนื้อหา |
action_container |
คอนเทนเนอร์สําหรับมุมมองการดําเนินการ |
ตัวอย่างเช่น รายการในรายการเนื้อหาด้านล่างได้รับการกําหนดค่าให้แสดงไอคอนและสวิตช์
ไอคอน
ระบบจะใช้มุมมองใดมุมมองหนึ่งต่อไปนี้สำหรับไอคอนหลัก โดยขึ้นอยู่กับประเภทไอคอนที่กำหนดค่าไว้สำหรับรายการ
| ยอดดู | |
|---|---|
icon |
ImageView ไอคอนมาตรฐาน |
content_icon |
ImageView ของไอคอนเนื้อหา |
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 3 รายการที่กําหนดไว้ในคอนเทนเนอร์ไอคอนในเลย์เอาต์รายการของรายการเนื้อหา แต่ระบบจะแสดงไอคอนได้สูงสุด 1 รายการตามประเภทไอคอนที่ระบุของรายการ 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 วางซ้อนมิติข้อมูลนี้
ค่าเพื่อเปลี่ยนขนาดของไอคอนเสริม