שימוש ברכיבי משנה של Material 3

כדי להקל על השימוש, הרבה מהרכיבים הקומפוזביליים המובנים של Material 3‏ (androidx.compose.material3) מטפלים בעצמם בשוליים הפנימיים, בהתאם למיקום הרכיבים הקומפוזביליים באפליקציה לפי מפרטי Material.

רכיבים קומפוזביליים לטיפול ב-inset

בהמשך מופיעה רשימה של רכיבי Material שמטפלים אוטומטית ב-insets.

סרגלי אפליקציות

• ‫TopAppBar / SmallTopAppBar / CenterAlignedTopAppBar / MediumTopAppBar / LargeTopAppBar: המערכת מוסיפה ריווח (padding) בצד העליון ובצדדים האופקיים של סרגלי המערכת, כי הערך הזה משמש בחלק העליון של החלון.
• ‫BottomAppBar: המרווח הפנימי מוחל על הצדדים התחתון והאופקיים של סרגלי המערכת.

קונטיינרים של תוכן

• ‫ModalDrawerSheet / DismissibleDrawerSheet / PermanentDrawerSheet (תוכן בתוך מגירת ניווט מודאלית): מוסיף לתוכן שוליים פנימיים אנכיים והתחלתיים.
• ‫ModalBottomSheet: החלת השוליים הפנימיים התחתונים.
• ‫NavigationBar : החלת השוליים הפנימיים התחתונים והאופקיים.
• ‫NavigationRail: הגדרת השוליים הפנימיים אנכיים והתחלתיים.

פיגום

כברירת מחדל, Scaffold מספקת לכם את התוספים כפרמטר PaddingValues שתוכלו להשתמש בו. ‫Scaffold לא חל על התוכן; האחריות לכך היא שלכם. לדוגמה, כדי להשתמש ב-insets האלה עם LazyColumn בתוך Scaffold:

Scaffold { innerPadding ->
    // innerPadding contains inset information for you to use and apply
    LazyColumn(
        // consume insets as scaffold doesn't do it by default
        modifier = Modifier.consumeWindowInsets(innerPadding),
        contentPadding = innerPadding
    ) {
        // ..
    }
}
InsetsSnippets.kt

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

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

שינוי ברירות המחדל של השוליים הפנימיים

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

לדוגמה, כדי להשבית את הטיפול בשוליים הפנימיים ב-LargeTopAppBar, מגדירים את הפרמטר windowInsets למופע ריק:

LargeTopAppBar(
    windowInsets = WindowInsets(0, 0, 0, 0),
    title = {
        Text("Hi")
    }
)
InsetsSnippets.kt