דף זה מפרט את אפשרויות ההתאמה האישית של פריטי רשימה CarUiListItem .
הפרדיגמה המקובלת לשימוש בספריית Car UI להצגת רשימה של פריטים היא שימוש ב- CarUiRecyclerView בשילוב עם אובייקטים CarUiListItemAdapter ו- CarUiListItem . התאמה אישית CarUiRecyclerView מכוסה ב- caruirecyclerview .
דרישות מוקדמות
התוכן הבא מניח הבנה של שכבות על משאבי זמן ריצה (RRO) המתוארות בהתאמה אישית של אפליקציות .
אודות CarUiListItem
פריטי רשימה יכולים להיות אחד משני סוגים ברמה גבוהה, כותרת או תוכן . כל אחד מהם מתואר להלן.
כּוֹתֶרֶת
CarUiListItemAdapter קושר אובייקטים מסוג CarUiHeaderListItem לתצוגה מנופחת מקובץ הפריסה car_ui_header_list_item , המכיל תצוגות אלה:
| צפיות | |
|---|---|
title | כותרת TextView |
body | תצוגת גוף טקסט |
לדוגמה, פריט רשימת הכותרות להלן מוגדר להצגת כותרת וטקסט גוף:
תוֹכֶן
CarUiListItemAdapter קושר אובייקטים מסוג CarUiHeaderListItem לתצוגה מנופחת מקובץ הפריסה car_ui_list_item . קובץ זה מכיל את התצוגות הבאות:
| צפיות | |
|---|---|
icon_container | מיכל עבור הסמל הראשי |
title | כותרת TextView |
body | תצוגת גוף טקסט |
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 . שים על ערך ממד זה כדי לשנות את גודל הסמל המשלים.