บทความนี้ให้รายละเอียดเกี่ยวกับตัวเลือกการปรับแต่งสำหรับรายการใน CarUiListItem
กระบวนทัศน์ที่ยอมรับสำหรับการใช้ไลบรารี Car UI เพื่อแสดงรายการคือการใช้ CarUiRecyclerView ร่วมกับออบเจ็กต์ CarUiListItemAdapter และ CarUiListItem การปรับแต่ง CarUiRecyclerView ครอบคลุมใน caruirecyclerview
ข้อกำหนดเบื้องต้น
เนื้อหาต่อไปนี้สันนิษฐานว่าเข้าใจ Runtime Resource Overlays (RRO) ที่อธิบายไว้ใน Customizing Apps
เกี่ยวกับ 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 สามรายการที่กำหนดไว้ภายในคอนเทนเนอร์ไอคอนในเค้าโครงรายการเนื้อหา แต่อย่างน้อยหนึ่งไอคอนจะแสดงตามประเภทไอคอนที่ระบุของรายการในรายการ ณ เวลาผูกรายการ 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 วางซ้อนค่ามิตินี้เพื่อเปลี่ยนขนาดของไอคอนเสริม