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) ) }
תוצאות
הרכיבים בממשק המשתמש מופיעים בשכבת-על בצורה צפויה בתוך מבנה הרשת הדו-ממדית. כשמסתמכים על סדר ההצהרות הרגיל, נמנעים ממכלים מורכבים בתצוגת עץ, ושומרים על קוד פריסה נקי ורספונסיבי.