התאמה אישית של רשימה דינמית   חלק מ-Android Jetpack.

רוצה לנסות את שיטת הכתיבה?

Jetpack Compose היא ערכת הכלים המומלצת לבניית ממשק משתמש ב-Android. איך עובדים עם פריסות ב-Compose

רשימות ורשתות 'לאט' →

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

שינוי הפריסה

RecyclerView משתמש במנהל פריסה כדי למקם את הפריטים השונים במסך ולהחליט מתי לעשות שימוש חוזר בתצוגות של פריטים שכבר לא גלויים למשתמש. כדי לעשות שימוש חוזר בתצוגה מפורטת או למחזר אותה, מנהל פריסה עשוי לבקש מהמתאם להחליף את תוכן התצוגה ברכיב אחר ממערך הנתונים. שימוש חוזר בתצוגות בדרך הזו משפרת את הביצועים, כי כך אפשר להימנע מיצירה של תצוגות מיותרות או מביצוע של חיפושים findViewById() יקרים. ספריית התמיכה של Android כוללת שלושה מנהלי פריסה רגילים, לכל אחד מהם יש אפשרויות רבות להתאמה אישית:

• LinearLayoutManager: סידור הפריטים ברשימה חד-מימדית. השימוש ב-RecyclerView עם LinearLayoutManager מספק פונקציונליות כמו פריסת ListView.
• GridLayoutManager: הפריטים מסודרים בתצוגת רשת דו-מימדית, כמו ריבועים בשחמט. השימוש ב-RecyclerView עם GridLayoutManager מספק פונקציונליות כמו פריסת GridView.
• StaggeredGridLayoutManager: הפריטים מסודרים בתצוגת רשת דו-מימדית, כאשר כל עמודה מוסטת מעט מהעמודה שלפניה, כמו הכוכבים בדגל ארה"ב.

אם מנהלי הפריסה האלה לא מתאימים לצרכים שלכם, תוכלו ליצור מנהל פריסה משלכם על ידי הרחבה של הכיתה המצומצמת RecyclerView.LayoutManager.

הוספת אנימציות לפריטים

בכל פעם שפריט משתנה, RecyclerView משתמש באנימטור כדי לשנות את המראה שלו. האנימטור הזה הוא אובייקט שמרחיב את המחלקה RecyclerView.ItemAnimator המופשטת. כברירת מחדל, ה-RecyclerView משתמש ב-DefaultItemAnimator כדי לספק את האנימציה. אם רוצים לספק אנימציות בהתאמה אישית, אפשר להגדיר אובייקט אנימטור משלכם על ידי הרחבה של RecyclerView.ItemAnimator.

הפעלת הבחירה של פריטי רשימה

הספרייה recyclerview-selection מאפשרת למשתמשים לבחור פריטים ברשימה RecyclerView באמצעות קלט מגע או עכבר. כך תוכלו לשמור על השליטה במראה החזותי של הפריט שנבחר. אתם יכולים גם לשמור על שליטה בכללי המדיניות ששולטים בהתנהגות הבחירה, כמו הפריטים שעומדים בדרישות לבחירה ומספר הפריטים שניתן לבחור.

כדי להוסיף תמיכה בבחירה למכונה של RecyclerView:

1. קובעים באיזה סוג של מפתח בחירה להשתמש, ואז יוצרים ItemKeyProvider.

   יש שלושה סוגים של מפתחות שאפשר להשתמש בהם כדי לזהות פריטים שנבחרו:

   • Parcelable וגם תתי-הסוגים שלו, כמו Uri
   • String
   • Long

   מידע מפורט על סוגי מפתחות בחירה זמין במאמר SelectionTracker.Builder.

2. מטמיעים את ItemDetailsLookup.

ItemDetailsLookup מאפשר לספרייה הנבחרת לגשת למידע על RecyclerView פריטים בהינתן MotionEvent. זהו מפעל שפועל ביעילות במכונה של ItemDetails שמגובות במכונה של RecyclerView.ViewHolder או נשלפה ממנה.

3. מעדכנים את אובייקטי הפריטים View ב-RecyclerView כך שישקפו אם המשתמש בחר אותם או ביטל את הבחירה שלהם.

   בספריית הבחירות אין קישוט חזותי שמוגדר כברירת מחדל לפריטים שנבחרו. יש לציין את הערך הזה כשמפעילים את onBindViewHolder(). אנחנו ממליצים על הגישה הבאה:

   • ב-onBindViewHolder(), קוראים ל-setActivated() – לא ל-setSelected() – באובייקט View עם true או false, בהתאם לכך שהפריט נבחר.
   • מעדכנים את הסגנון של התצוגה כך שייצג את הסטטוס המופעל. מומלץ להשתמש במשאב של רשימת מצבי צבע כדי להגדיר את העיצוב.
4. משתמשים ב-ActionMode כדי לספק למשתמש כלים לביצוע פעולה על הבחירה.

כדי לקבל התראה כשהבחירה משתנה, צריך לרשום SelectionTracker.SelectionObserver. כשהמבחר נוצר בפעם הראשונה, מפעילים את ActionMode כדי להציג אותו למשתמש ולספק לו פעולות ספציפיות למבחר. לדוגמה, אפשר להוסיף לחצן מחיקה לסרגל ActionMode ולחבר את החץ לאחור בסרגל כדי לנקות את הבחירה. כשהבחירה תהיה ריקה – אם המשתמש ינקה את הבחירה בפעם האחרונה – צריך לסיים את מצב הפעולה.

5. ביצוע פעולות משניות שפורשו.

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

6. אספו את כל הפריטים באמצעות SelectionTracker.Builder.

בדוגמה הבאה מוסבר איך להרכיב את החלקים האלה:

Kotlin

    var tracker = SelectionTracker.Builder(
        "my-selection-id",
        recyclerView,
        StableIdKeyProvider(recyclerView),
        MyDetailsLookup(recyclerView),
        StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build()
    

Java

    SelectionTracker tracker = new SelectionTracker.Builder<>(
            "my-selection-id",
            recyclerView,
            new StableIdKeyProvider(recyclerView),
            new MyDetailsLookup(recyclerView),
            StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build();
    

כדי ליצור מכונה של SelectionTracker, האפליקציה צריכה לספק את אותו RecyclerView.Adapter שבו משתמשים כדי לאתחל את RecyclerView ל-SelectionTracker.Builder. לכן אחרי שיוצרים את המכונה SelectionTracker, מחדירים אותה ל-RecyclerView.Adapter. אחרת, לא תוכלו לבדוק את הסטטוס שנבחר של פריט באמצעות השיטה onBindViewHolder().

7. כוללים את הבחירה באירועים של מחזור החיים של הפעילות.

כדי לשמור את מצב הבחירה באירועים במהלך מחזור החיים של הפעילות, האפליקציה צריכה להפעיל את השיטות onSaveInstanceState() ו-onRestoreInstanceState() של מעקב הבחירות מהשיטות onSaveInstanceState() ו-onRestoreInstanceState() של הפעילות, בהתאמה. האפליקציה צריכה גם לספק מזהה ייחודי לבחירה ל-constructor של SelectionTracker.Builder. המזהה הזה נדרש כי לפעילות או למקטע יכולה להיות יותר מרשימה ייחודית אחת שניתן לבחור, וכולן צריכות להישאר במצב השמור שלהן.

מקורות מידע נוספים

מידע נוסף זמין במקורות המידע הבאים.

• אפליקציית ההדגמה של Sunflower באמצעות RecyclerView.
• שימוש ב-RecyclerView כדי להציג רשימה שניתן לגלול בה
• קורס ה-codelab יסודות Kotlin ל-Android: יסודות RecyclerView.