אפשרויות של התאמה אישית ב-CarUiListItem

בדף הזה מפורטות אפשרויות ההתאמה האישית של פריטים ברשימה CarUiListItem.

המודל המקובל לשימוש בספריית ממשק המשתמש שברכב כדי להציג רשימת פריטים הוא להשתמש ב-CarUiRecyclerView בשילוב עם אובייקטים מסוג CarUiListItemAdapter ו-CarUiListItem. ההתאמה האישית של CarUiRecyclerView מפורטת בקטע caruirecyclerview.

דרישות מוקדמות

התוכן הבא מבוסס על ההבנה של שכבות-על של משאבים בסביבת זמן ריצה (RRO) שמתוארת בקטע התאמה אישית של אפליקציות.

מידע על CarUiListItem

פריטים ברשימות יכולים להיות מאחד משני הסוגים ברמה גבוהה: header או content. בהמשך מוסבר על כל אחת מהן.

CarUiListItemAdapter מקשר אובייקטים מסוג CarUiHeaderListItem לתצוגה שמנפחת מקובץ הפריסה car_ui_header_list_item, שמכיל את התצוגות הבאות:

צפיות
title Title TextView
body Body TextView

לדוגמה, פריט הרשימה של הכותרת שבהמשך מוגדר להציג כותרת וגוף טקסט:

תוכן

CarUiListItemAdapter מקשר אובייקטים מסוג CarUiHeaderListItem לתצוגה שמנפחים מקובץ הפריסה car_ui_list_item. הקובץ מכיל את התצוגות הבאות:

צפיות
icon_container מאגר לסמל הראשי
title Title TextView
body 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

התאמה אישית של הטקסט

סגנון הטקסט בכותרות ובפריטים ברשימה של התוכן נשלט על ידי סגנונות המראה של הטקסט שמוגדרים בספריית ממשק המשתמש ברכב. כדי לשנות את סגנון הטקסט של הפריטים ברשימה, משנים את הסגנונות המתאימים שמפורטים בהמשך.

כדי להתאים אישית את הסגנונות של הכותרות:

סגנונות של כותרות
טקסט הכותרת @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. כדי לשנות את גודל הסמל המשלים, אפשר להוסיף שכבה על ערך המאפיין הזה.