ตัวเลือกการปรับแต่งสำหรับ CarUiListItem

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