רשימות ורשתות

באפליקציות רבות צריך להציג אוספים של פריטים. במאמר הזה נסביר איך לעשות זאת ביעילות ב-Jetpack Compose.

אם אתם יודעים שבתרחיש לדוגמה שלכם אין צורך בגלילה, תוכלו להשתמש ב-Column או ב-Row (בהתאם לכיוון) ולהפיק את התוכן של כל פריט על ידי איטרציה ברשימה באופן הבא:

@Composable
fun MessageList(messages: List<Message>) {
    Column {
        messages.forEach { message ->
            MessageRow(message)
        }
    }
}
LazyListSnippets.kt

אפשר להפוך את Column לגלילה באמצעות המשתנה המשנה verticalScroll().

רשימות עצלות

אם אתם צריכים להציג מספר גדול של פריטים (או רשימה באורך לא ידוע), שימוש בפריסה כמו Column עלול לגרום לבעיות בביצועים, כי כל הפריטים יתוכננו ויוצגו, גם אם הם לא גלויים.

Compose מספק קבוצה של רכיבים שמרכיבים ומציבים רק פריטים שגלויים באזור התצוגה של הרכיב. הרכיבים האלה כוללים את LazyColumn ואת LazyRow.

הערה: אם השתמשתם בווידג'ט RecyclerView, הרכיבים האלה פועלים לפי אותם עקרונות.

כפי שרואים מהשם, ההבדל בין LazyColumn לבין LazyRow הוא בכיוון שבו הפריטים מוצגים והגלילה מתבצעת. LazyColumn יוצר רשימה עם גלילה אנכית, ו-LazyRow יוצר רשימה עם גלילה אופקית.

הרכיבים הלא פעילים שונים מרוב הפריסות ב-Compose. במקום לקבל פרמטר של חסימה של תוכן @Composable, שמאפשר לאפליקציות להפיק ישירות רכיבים שניתנים לשילוב, הרכיבים הלא פעילים מספקים בלוק LazyListScope.(). הבלוק LazyListScope מציע DSL שמאפשר לאפליקציות לתאר את תוכן הפריטים. לאחר מכן, הרכיב הלא-אקטיבי אחראי להוספת התוכן של כל פריט בהתאם לפריסה ולמיקום הגלילה.

מונח מפתח: DSL הוא ראשי תיבות של שפה ייעודית לדומיין. למידע נוסף על האופן שבו Compose מגדיר שפות DSL לממשקי API מסוימים, אפשר לעיין במסמכי העזרה של Kotlin for Compose.

LazyListScope DSL

ה-DSL של LazyListScope כולל כמה פונקציות לתיאור פריטים בפריסה. ברמה הבסיסית ביותר, הפונקציה item() מוסיפה פריט אחד ואז מוסיפה items(Int) כמה פריטים:

LazyColumn {
    // Add a single item
    item {
        Text(text = "First item")
    }

    // Add 5 items
    items(5) { index ->
        Text(text = "Item: $index")
    }

    // Add another single item
    item {
        Text(text = "Last item")
    }
}
LazyListSnippets.kt

יש גם כמה פונקציות של תוספים שמאפשרות להוסיף אוספים של פריטים, כמו List. התוספים האלה מאפשרים לנו להעביר בקלות את הדוגמה של Column שלמעלה:

/**
 * import androidx.compose.foundation.lazy.items
 */
LazyColumn {
    items(messages) { message ->
        MessageRow(message)
    }
}
LazyListSnippets.kt

יש גם וריאנט של פונקציית התוסף items() שנקרא itemsIndexed(), שמספק את המדד. לפרטים נוספים עיינו במפרט של השיטה ב-LazyListScope.

רשתות טעינה מדורגת

הרכיבים הניתנים לקישור LazyVerticalGrid ו-LazyHorizontalGrid תומכים בהצגת פריטים בתצוגת רשת. בתצוגת רשת אנכית עם Lazy, הפריטים יוצגו במארז שאפשר לגלול בו אנכית, לאורך כמה עמודות. בתצוגת רשת אופקית עם Lazy, ההתנהגות תהיה זהה בציר האופקי.

לרשתות יש אותן יכולות API חזקות כמו לרשימות, והן גם משתמשות ב-DSL דומה מאוד – LazyGridScope.() – כדי לתאר את התוכן.

הפרמטר columns ב-LazyVerticalGrid והפרמטר rows ב-LazyHorizontalGrid קובעים איך התאים ירכיבו עמודות או שורות. בדוגמה הבאה מוצגים פריטים בתוך רשת, באמצעות GridCells.Adaptive כדי להגדיר שכל עמודה תהיה רחבה לפחות 128.dp:

LazyVerticalGrid(
    columns = GridCells.Adaptive(minSize = 128.dp)
) {
    items(photos) { photo ->
        PhotoItem(photo)
    }
}
LazyListSnippets.kt

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

אם אתם יודעים מהו מספר העמודות המדויק שבו תרצו להשתמש, תוכלו לספק במקום זאת מופע של GridCells.Fixed שמכיל את מספר העמודות הנדרשות.

אם בתרשים שלכם יש פריטים מסוימים שצריכים להיות בגדלים לא סטנדרטיים, תוכלו להשתמש בתמיכה של התצוגה בחלוקה לרשת כדי להגדיר פריטים עם רוחב עמודות מותאם אישית. מציינים את רוחב העמודה באמצעות הפרמטר span של השיטות LazyGridScope DSL item ו-items. maxLineSpan, אחד מהערכים של היקף התצוגה, שימושי במיוחד כשמשתמשים בגודל מותאם, כי מספר העמודות לא קבוע. בדוגמה הזו מוסבר איך לספק רוחב של שורה מלאה:

LazyVerticalGrid(
    columns = GridCells.Adaptive(minSize = 30.dp)
) {
    item(span = {
        // LazyGridItemSpanScope:
        // maxLineSpan
        GridItemSpan(maxLineSpan)
    }) {
        CategoryCard("Fruits")
    }
    // ...
}
LazyListSnippets.kt

רשת מדורגת עם טעינה מדורגת

הערה: LazyVerticalStaggeredGrid ו-LazyHorizontalStaggeredGrid הם ניסיוניים. אפשר לשלוח משוב בכלי למעקב אחר בעיות.

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

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

קטע הקוד הבא הוא דוגמה בסיסית לשימוש ב-LazyVerticalStaggeredGrid עם רוחב 200.dp לכל פריט:

LazyVerticalStaggeredGrid(
    columns = StaggeredGridCells.Adaptive(200.dp),
    verticalItemSpacing = 4.dp,
    horizontalArrangement = Arrangement.spacedBy(4.dp),
    content = {
        items(randomSizedPhotos) { photo ->
            AsyncImage(
                model = photo,
                contentScale = ContentScale.Crop,
                contentDescription = null,
                modifier = Modifier
                    .fillMaxWidth()
                    .wrapContentHeight()
            )
        }
    },
    modifier = Modifier.fillMaxSize()
)
LazyListSnippets.kt

איור 1. דוגמה לרשת אנכית מדורגת עם פריסת 'עיכוב טעינה'

כדי להגדיר מספר קבוע של עמודות, אפשר להשתמש ב-StaggeredGridCells.Fixed(columns) במקום ב-StaggeredGridCells.Adaptive. הפעולה הזו מחלקת את הרוחב הזמין במספר העמודות (או השורות ברשת אופקית), וכל פריט תופס את הרוחב (או הגובה של רשת אופקית):

LazyVerticalStaggeredGrid(
    columns = StaggeredGridCells.Fixed(3),
    verticalItemSpacing = 4.dp,
    horizontalArrangement = Arrangement.spacedBy(4.dp),
    content = {
        items(randomSizedPhotos) { photo ->
            AsyncImage(
                model = photo,
                contentScale = ContentScale.Crop,
                contentDescription = null,
                modifier = Modifier
                    .fillMaxWidth()
                    .wrapContentHeight()
            )
        }
    },
    modifier = Modifier.fillMaxSize()
)
LazyListSnippets.kt

איור 2. דוגמה לרשת אנכית מדורגת עם עמודות קבועות

המרווח הפנימי של התוכן

לפעמים תצטרכו להוסיף רווח מסביב לקצוות התוכן. הרכיבים העצלים מאפשרים להעביר חלק מה-PaddingValues לפרמטר contentPadding כדי לתמוך בכך:

LazyColumn(
    contentPadding = PaddingValues(horizontal = 16.dp, vertical = 8.dp),
) {
    // ...
}
LazyListSnippets.kt

בדוגמה הזו, מוסיפים 16.dp של ריפוד לקצוות האופקיים (ימין ושמאל), ואז 8.dp לחלק העליון והתחתון של התוכן.

חשוב לזכור שהמילוי הזה חל על התוכן, ולא על LazyColumn עצמו. בדוגמה שלמעלה, הפריט הראשון יוסיף 8.dp למרומיו, הפריט האחרון יוסיף 8.dp לתחתיתו וכל הפריטים יקבלו 16.dp למעלה ולמטה.

רווחים בין רכיבי תוכן

כדי להוסיף רווחים בין הפריטים, אפשר להשתמש ב-Arrangement.spacedBy(). בדוגמה הבאה מתווסף רווח של 4.dp בין כל פריט:

LazyColumn(
    verticalArrangement = Arrangement.spacedBy(4.dp),
) {
    // ...
}
LazyListSnippets.kt

באופן דומה, עבור LazyRow:

LazyRow(
    horizontalArrangement = Arrangement.spacedBy(4.dp),
) {
    // ...
}
LazyListSnippets.kt

עם זאת, אפשר להציג בגריד גם תמונות אנכיות וגם תמונות אופקיות:

LazyVerticalGrid(
    columns = GridCells.Fixed(2),
    verticalArrangement = Arrangement.spacedBy(16.dp),
    horizontalArrangement = Arrangement.spacedBy(16.dp)
) {
    items(photos) { item ->
        PhotoItem(item)
    }
}
LazyListSnippets.kt

מפתחות של פריטים

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

הערה: מידע נוסף על האופן שבו Compose שומר את המצב זמין במאמר בנושא מצב

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

LazyColumn {
    items(
        items = messages,
        key = { message ->
            // Return a stable + unique key for the item
            message.id
        }
    ) { message ->
        MessageRow(message)
    }
}
LazyListSnippets.kt

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

LazyColumn {
    items(books, key = { it.id }) {
        val rememberedValue = remember {
            Random.nextInt()
        }
    }
}
LazyListSnippets.kt

עם זאת, יש הגבלה אחת על סוגי המפתחות שאפשר להשתמש בהם כמפתחות פריטים. סוג המפתח צריך לתמוך ב-Bundle, המנגנון של Android לשמירת המצבים בזמן יצירה מחדש של הפעילות. Bundle תומך בסוגי נתונים כמו פרימיטיבים, משתני enum או Parcelables.

LazyColumn {
    items(books, key = {
        // primitives, enums, Parcelable, etc.
    }) {
        // ...
    }
}
LazyListSnippets.kt

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

LazyColumn {
    items(books, key = { it.id }) {
        val rememberedValue = rememberSaveable {
            Random.nextInt()
        }
    }
}
LazyListSnippets.kt

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

אם השתמשתם בווידג'ט של RecyclerView, סימן שהוא מוסיפים אנימציה לשינויי פריטים באופן אוטומטי. בפריטי עיצוב עם טעינה מדורגת יש את אותה פונקציונליות גם כשמשנים את הסדר של הפריטים. ה-API פשוט – צריך רק להגדיר את המשתנה animateItem לתוכן הפריט:

LazyColumn {
    // It is important to provide a key to each item to ensure animateItem() works as expected.
    items(books, key = { it.id }) {
        Row(Modifier.animateItem()) {
            // ...
        }
    }
}
LazyListSnippets.kt

אפשר גם לספק מפרט אנימציה מותאם אישית, אם צריך:

LazyColumn {
    items(books, key = { it.id }) {
        Row(
            Modifier.animateItem(
                fadeInSpec = tween(durationMillis = 250),
                fadeOutSpec = tween(durationMillis = 100),
                placementSpec = spring(stiffness = Spring.StiffnessLow, dampingRatio = Spring.DampingRatioMediumBouncy)
            )
        ) {
            // ...
        }
    }
}
LazyListSnippets.kt

חשוב לספק מפתחות לפריטים כדי שאפשר יהיה למצוא את המיקום החדש של הרכיב שהועתק.

כותרות דביקות (ניסיוני)

זהירות: ממשקי API ניסיוניים עשויים להשתנות בעתיד או שהם יוסרו לחלוטין.

התבנית 'כותרת דביקה' מועילה כשמציגים רשימות של נתונים מקובצים. בהמשך מוצגת דוגמה ל'רשימת אנשי קשר', שמקובצים לפי האות הראשונה של כל איש קשר:

כדי ליצור כותרת צפה עם LazyColumn, אפשר להשתמש בפונקציה הניסיונית stickyHeader(), ולספק את תוכן הכותרת:

@OptIn(ExperimentalFoundationApi::class)
@Composable
fun ListWithHeader(items: List<Item>) {
    LazyColumn {
        stickyHeader {
            Header()
        }

        items(items) { item ->
            ItemRow(item)
        }
    }
}
LazyListSnippets.kt

כדי ליצור רשימה עם כמה כותרות, כמו הדוגמה 'רשימת אנשי קשר' שלמעלה, אפשר:

// This ideally would be done in the ViewModel
val grouped = contacts.groupBy { it.firstName[0] }

@OptIn(ExperimentalFoundationApi::class)
@Composable
fun ContactsList(grouped: Map<Char, List<Contact>>) {
    LazyColumn {
        grouped.forEach { (initial, contactsForInitial) ->
            stickyHeader {
                CharacterHeader(initial)
            }

            items(contactsForInitial) { contact ->
                ContactListItem(contact)
            }
        }
    }
}
LazyListSnippets.kt

תגובה למיקום גלילה

אפליקציות רבות צריכות להגיב לשינויים במיקום הגלילה ובפריסה של הפריטים. הרכיבים Lazy תומכים בתרחיש לדוגמה הזה על-ידי הרמה של LazyListState:

@Composable
fun MessageList(messages: List<Message>) {
    // Remember our own LazyListState
    val listState = rememberLazyListState()

    // Provide it to LazyColumn
    LazyColumn(state = listState) {
        // ...
    }
}
LazyListSnippets.kt

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

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

@Composable
fun MessageList(messages: List<Message>) {
    Box {
        val listState = rememberLazyListState()

        LazyColumn(state = listState) {
            // ...
        }

        // Show the button if the first visible item is past
        // the first item. We use a remembered derived state to
        // minimize unnecessary compositions
        val showButton by remember {
            derivedStateOf {
                listState.firstVisibleItemIndex > 0
            }
        }

        AnimatedVisibility(visible = showButton) {
            ScrollToTopButton()
        }
    }
}
LazyListSnippets.kt

הערה: בדוגמה שלמעלה נעשה שימוש ב-derivedStateOf() כדי לצמצם יצירות לא נחוצות. מידע נוסף זמין במאמרים בנושא תופעות לוואי.

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

val listState = rememberLazyListState()

LazyColumn(state = listState) {
    // ...
}

LaunchedEffect(listState) {
    snapshotFlow { listState.firstVisibleItemIndex }
        .map { index -> index > 0 }
        .distinctUntilChanged()
        .filter { it }
        .collect {
            MyAnalyticsService.sendScrolledPastFirstItemEvent()
        }
}
LazyListSnippets.kt

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

שליטה במיקום הגלילה

בנוסף לתגובה למיקום הגלילה, כדאי גם לאפליקציות להיות מסוגלות לשלוט במיקום הגלילה. LazyListState תומך בכך באמצעות הפונקציה scrollToItem(), שנועלת 'באופן מיידי' את מיקום הגלילה, ו-animateScrollToItem() שגוללת באמצעות אנימציה (שנקראת גם גלילה חלקה):

הערה: גם scrollToItem() וגם animateScrollToItem() הן פונקציות השהיה, כלומר צריך להפעיל אותן ב-coroutine. במסמכי התיעוד בנושא Coroutine מוסבר איך לעשות את זה ב-Composes.

@Composable
fun MessageList(messages: List<Message>) {
    val listState = rememberLazyListState()
    // Remember a CoroutineScope to be able to launch
    val coroutineScope = rememberCoroutineScope()

    LazyColumn(state = listState) {
        // ...
    }

    ScrollToTopButton(
        onClick = {
            coroutineScope.launch {
                // Animate scroll to the first item
                listState.animateScrollToItem(index = 0)
            }
        }
    )
}
LazyListSnippets.kt

קבוצות נתונים גדולות (דפים)

ספריית הגיליון מאפשרת לאפליקציות לתמוך ברשימות גדולות של פריטים, ולטעון ולהציג קטעים קטנים של הרשימה לפי הצורך. ב-Paging 3.0 ואילך יש תמיכה ב-Compose דרך הספרייה androidx.paging:paging-compose.

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

כדי להציג רשימה של תוכן שמחולק לדפים, אפשר להשתמש בפונקציית התוסף collectAsLazyPagingItems(), ולאחר מכן להעביר את הערך המוחזר LazyPagingItems אל items() ב-LazyColumn. בדומה לתמיכה בחלוקה לדפים בתצוגות, אפשר להציג תוספי placeholder בזמן שהנתונים נטענים על ידי בדיקה אם הערך של item הוא null:

@Composable
fun MessageList(pager: Pager<Int, Message>) {
    val lazyPagingItems = pager.flow.collectAsLazyPagingItems()

    LazyColumn {
        items(
            lazyPagingItems.itemCount,
            key = lazyPagingItems.itemKey { it.id }
        ) { index ->
            val message = lazyPagingItems[index]
            if (message != null) {
                MessageRow(message)
            } else {
                MessagePlaceholder()
            }
        }
    }
}
LazyListSnippets.kt

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

טיפים לשימוש בפריסות 'איט'

יש כמה טיפים שאפשר להיעזר בהם כדי לוודא שהפריסות עם טעינת נתונים בזמן אמת פועלות כמצופה.

הימנעו משימוש בפריטים בגודל 0 פיקסלים

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

@Composable
fun Item(imageUrl: String) {
    AsyncImage(
        model = rememberAsyncImagePainter(model = imageUrl),
        modifier = Modifier.size(30.dp),
        contentDescription = null
        // ...
    )
}
LazyListSnippets.kt

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

הימנעו מהטמעת רכיבים שאפשר לגלול אותם באותו כיוון

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

// throws IllegalStateException
Column(
    modifier = Modifier.verticalScroll(state)
) {
    LazyColumn {
        // ...
    }
}
LazyListSnippets.kt

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

LazyColumn {
    item {
        Header()
    }
    items(data) { item ->
        PhotoItem(item)
    }
    item {
        Footer()
    }
}
LazyListSnippets.kt

חשוב לזכור: מותר להשתמש בתצוגות עם כיוונים שונים בתוך תצוגות אחרות, למשל תצוגת הורה Row עם גלילה ותצוגת צאצא LazyColumn:

Row(
    modifier = Modifier.horizontalScroll(scrollState)
) {
    LazyColumn {
        // ...
    }
}
LazyListSnippets.kt

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

Column(
    modifier = Modifier.verticalScroll(scrollState)
) {
    LazyColumn(
        modifier = Modifier.height(200.dp)
    ) {
        // ...
    }
}
LazyListSnippets.kt

צריך להיזהר ולא להוסיף כמה רכיבים לפריט אחד

בדוגמה הזו, פונקציית הלמה של הפריט השני פולטת 2 פריטים בבלוק אחד:

LazyVerticalGrid(
    columns = GridCells.Adaptive(100.dp)
) {
    item { Item(0) }
    item {
        Item(1)
        Item(2)
    }
    item { Item(3) }
    // ...
}
LazyListSnippets.kt

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

כשנוצר מספר רכיבים כחלק מפריט אחד, הם מטפלים בהם כישות אחת. כלומר, כבר אי אפשר להרכיב אותם בנפרד. אם אלמנט אחד מופיע במסך, צריך ליצור ולמדוד את כל הרכיבים התואמים לפריט. שימוש מוגזם עלול לפגוע בביצועים. במקרה הקיצוני של הכנסת כל הרכיבים בפריט אחד, הפעולה הזו מבטלת לחלוטין את מטרת השימוש בפריסות Lazy. חוץ מבעיות פוטנציאליות בביצועים, הוספה של עוד רכיבים לפריט אחד תפריע גם ל-scrollToItem() ול-animateScrollToItem().

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

LazyVerticalGrid(
    columns = GridCells.Adaptive(100.dp)
) {
    item { Item(0) }
    item {
        Item(1)
        Divider()
    }
    item { Item(2) }
    // ...
}
LazyListSnippets.kt

כדאי להשתמש בסידור מותאם אישית

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

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

object TopWithFooter : Arrangement.Vertical {
    override fun Density.arrange(
        totalSize: Int,
        sizes: IntArray,
        outPositions: IntArray
    ) {
        var y = 0
        sizes.forEachIndexed { index, size ->
            outPositions[index] = y
            y += size
        }
        if (y < totalSize) {
            val lastIndex = outPositions.lastIndex
            outPositions[lastIndex] = totalSize - sizes.last()
        }
    }
}
LazyListSnippets.kt

כדאי להוסיף את contentType

נתחיל עם 'פיתוח נייטיב 1.2'. כדי למקסם את הביצועים של הפריסה 'לעדנים', כדאי להוסיף את הפקודה contentType לרשימות או למשבצות. כך תוכלו לציין את סוג התוכן של כל פריט בפריסת האתר, במקרים שבהם אתם יוצרים רשימה או רשת שמכילות כמה סוגים שונים של פריטים:

LazyColumn {
    items(elements, contentType = { it.type }) {
        // ...
    }
}
LazyListSnippets.kt

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

מדידת הביצועים

אפשר למדוד את הביצועים של פריסה עם טעינת פריטים בזמן אמת (Lazy) באופן מהימן רק כשהיא פועלת במצב הפצה ועם אופטימיזציה של R8 מופעלת. ב-builds לניפוי באגים, יכול להיות שהגלילה של פריסה עצלה תהיה איטית יותר. למידע נוסף בנושא הזה, קראו את המאמר כתיבת ביצועים.