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