CarUiListItem

บทความนี้ให้รายละเอียดเกี่ยวกับตัวเลือกการปรับแต่งสำหรับรายการใน 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 วางซ้อนค่ามิตินี้เพื่อเปลี่ยนขนาดของไอคอนเสริม