שכבות-על של רכיבים בממשק המשתמש עם רשת

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

‫Jetpack Compose Grid API מיועד לפריסות מסך מבניות דו-ממדיות. בניגוד לרשתות עם טעינה מדורגת, שמתאימות לקבוצות נתונים גדולות, Grid מאפשר להגדיר מבנה פריסה קבוע או רספונסיבי באמצעות טראקים (שורות ועמודות), מרווחים ואזורי רשת. כדי למקם פריטים במבנה הזה, משתמשים ב-Modifier.gridItem, שמאפשר שליטה מפורשת במיקום ובפריסה בתוך מאגר הרשת.

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

שיטות מומלצות

  • סדר ההצהרה: Grid פועל לפי סדר zIndex רגיל שמבוסס על סדר ההצהרה בתוך הבלוק Grid. פריטים שמוצהרים מאוחר יותר בבלוק התוכן Grid מוצגים מעל פריטים שמוצהרים מוקדם יותר.
  • שליטה מפורשת ב-z-index: משתמשים ב-Modifier.zIndex אם צריך לשלוט באופן מפורש בסדר ברירת המחדל של השרטוט של רכיבים חופפים, או לשנות אותו.
  • אזור עם שם לעומת שכבות-על של פריטים: השתמשו ב-Grid ובאזורים עם שם כדי להגדיר את המבנה של הפריסה, אבל השאירו את הלוגיקה המורכבת של שכבות-העל בתוך ה-gridItem הספציפי אם שכבות-העל האלה קשורות באופן לוגי לתא הזה ברשת.
  • טווחים מכוונים לשכבות-על: כשמוסיפים שכבת-על, חשוב לוודא שהפרמטרים rowSpan ו-columnSpan מכוונים לרכיבים החופפים כדי לקבוע כמה מהתוכן שמתחת מוסתר.

אלמנטים

  • Grid: מאגר פריסה מבני דו-ממדי
  • ‫GridConfigurationScope.area: פונקציית היקף שמשמשת להגדרת אזורים בעלי שם ואזורי שכבת-על לאורך מסלולי רשת
  • ‫Modifier.gridItem: משתנה שמשמש למיקום ולפריסה של רכיבים קומפוזביליים לאורך טראקים של רשת או באזורי רשת עם שם
  • ‫Modifier.zIndex: משתנה שמשמש לשליטה מפורשת בסדר השרטוט והשכבות

צעדים

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

1. הגדרת הרשת

יוצרים הגדרה של רכיב ה-Composable‏ Grid ומציינים את מסלולי השורות והעמודות, וגם את האזורים בעלי השמות שמשתרעים על פני תאים כדי להגדיר אזורי שכבת-על:

enum class Areas { BASE, OVERLAY }

val gridConfig: GridConfigurationScope.() -> Unit = {
    repeat(3) {
        column(GridTrackSize.Fixed(100.dp))
    }
    row(GridTrackSize.Fixed(100.dp))

    area(areaId = Areas.BASE, row = 1, column = 1, columnSpan = 2)
    // Define a named area spanning multiple columns that overlaps other cells
    area(areaId = Areas.OVERLAY, row = 1, column = 2, columnSpan = 2)
}

2. הצבת תוכן בסיסי והצהרה על שכבות-על

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

Grid(
    config = gridConfig,
) {
    // Base Layer
    TextCard("BASE", Modifier.gridItem(areaId = Areas.BASE))
    // Overlay Layer
    TextCard(
        "OVERLAY",
        Modifier.gridItem(areaId = Areas.OVERLAY),
        color = Color(0xDD4B608D)
    )
}

תוצאות

הרכיבים בממשק המשתמש מופיעים בשכבת-על בצורה צפויה בתוך מבנה הרשת הדו-ממדית. כשמסתמכים על סדר ההצהרות הרגיל, נמנעים ממכלים מורכבים בתצוגת עץ, ושומרים על קוד פריסה נקי ורספונסיבי.

פריסת רשת שמוצגים בה רכיבים בממשק המשתמש
איור 1. רכיבים חופפים בממשק המשתמש בתוך רשת בפיתוח נייטיב.