از مواد 3 درونی استفاده کنید

برای سهولت استفاده، بسیاری از مواد داخلی 3 composable ( androidx.compose.material3 ) بر اساس نحوه قرارگیری اجزای سازنده در برنامه شما با توجه به مشخصات Material، خود به کار می‌روند.

توجه: مؤلفه‌های Material 2 ( androidx.compose.material ) به‌طور خودکار درون‌ها را مدیریت نمی‌کنند. با این حال، می توانید به inset ها دسترسی داشته باشید و آنها را به صورت دستی اعمال کنید. در androidx.compose.material 1.6.0 و نسخه های جدیدتر از پارامتر windowInsets برای اعمال دستی Inset ها برای BottomAppBar ، TopAppBar ، BottomNavigation و NavigationRail استفاده کنید. به همین ترتیب، از پارامتر contentWindowInsets برای Scaffold استفاده کنید. در غیر این صورت، اینست ها را به صورت دستی به عنوان بالشتک اعمال کنید.

مواد ترکیبی هندلینگ داخلی

در زیر لیستی از اجزای متریال است که به طور خودکار inset ها را مدیریت می کنند.

نوارهای برنامه

• TopAppBar / SmallTopAppBar / CenterAlignedTopAppBar / MediumTopAppBar / LargeTopAppBar : دو طرف بالا و افقی نوارهای سیستم را به عنوان بالشتک اعمال می کند زیرا در بالای پنجره استفاده می شود.
• BottomAppBar : دو طرف پایین و افقی نوارهای سیستم را به عنوان بالشتک اعمال می کند.

ظروف محتوا

• ModalDrawerSheet / DismissibleDrawerSheet / PermanentDrawerSheet (محتوا در یک کشوی ناوبری معین): ورودی های عمودی و شروع را به محتوا اعمال می کند.
• ModalBottomSheet : ورودی های پایینی را اعمال می کند.
• NavigationBar : ورودی های پایین و افقی را اعمال می کند.
• NavigationRail : ورودی های عمودی و شروع را اعمال می کند.

داربست

به طور پیش‌فرض، Scaffold ورودی‌هایی را به‌عنوان پارامتر paddingValues ​​برای مصرف و استفاده شما فراهم می‌کند. Scaffold در داخل محتوا را اعمال نمی کند. این مسئولیت با شماست به عنوان مثال، برای مصرف این inset ها با 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 با صفحه نمایش لبه به لبه غیرفعال و فعال نشان می دهد:

درج های پیش فرض را لغو کنید

می‌توانید پارامتر windowInsets را به composable تغییر دهید تا رفتار composable را پیکربندی کنید. این پارامتر می تواند نوع دیگری از درج پنجره باشد که به جای آن اعمال می شود، یا با عبور دادن یک نمونه خالی غیرفعال می شود: WindowInsets(0, 0, 0, 0) .

به عنوان مثال، برای غیرفعال کردن مدیریت inset در LargeTopAppBar ، پارامتر windowInsets را روی یک نمونه خالی تنظیم کنید:

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