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

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

הערה: רכיבי Material 2 (androidx.compose.material) לא מטפלים אוטומטית ב-insets. עם זאת, אפשר לקבל גישה לתמונות הממוזערות ולהחיל אותן באופן ידני. ב-androidx.compose.material 1.6.0 ומגרסאות מאוחרות יותר, משתמשים בפרמטר windowInsets כדי להחיל את השוליים הפנימיים באופן ידני על BottomAppBar,‏ TopAppBar,‏ BottomNavigation ועל NavigationRail. באופן דומה, משתמשים בפרמטר contentWindowInsets עבור Scaffold. אחרת, צריך להחיל את השוליים הפנימיים באופן ידני כריפוד.

פונקציות קומפוזביליות לטיפול ב-inset

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

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

• ‫TopAppBar / CenterAlignedTopAppBar / MediumTopAppBar / LargeTopAppBar: מוסיף ריווח לחלק העליון ולצדדים האופקיים של סרגלי המערכת, כי הוא ממוקם בחלק העליון של החלון.
• ‫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 שמועבר לרכיב ה-Composable כדי להגדיר את ההתנהגות של הרכיב. הפרמטר הזה יכול להיות סוג אחר של שוליים פנימיים של חלון שיוחל במקום זאת, או שהוא יכול להיות מושבת על ידי העברת מופע ריק: WindowInsets(0, 0, 0, 0).

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

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