برگ زیرین جزئی

می‌توانید برگه پایین را به‌طور جزئی نشان دهید و سپس به کاربر اجازه دهید آن را تمام‌صفحه کند یا ببندد.

برای انجام این کار، ModalBottomSheet خود را به نمونه‌ای از SheetState با skipPartiallyExpanded تنظیم‌شده روی false ارسال کنید.

مثال

این مثال نشان می‌دهد که چگونه می‌توانید از ویژگی sheetState ModalBottomSheet برای نمایش جزئی برگه در ابتدا استفاده کنید:

@Composable
fun PartialBottomSheet() {
    var showBottomSheet by remember { mutableStateOf(false) }
    val sheetState = rememberModalBottomSheetState(
        skipPartiallyExpanded = false,
    )

    Column(
        modifier = Modifier.fillMaxWidth(),
        horizontalAlignment = Alignment.CenterHorizontally,
    ) {
        Button(
            onClick = { showBottomSheet = true }
        ) {
            Text("Display partial bottom sheet")
        }

        if (showBottomSheet) {
            ModalBottomSheet(
                modifier = Modifier.fillMaxHeight(),
                sheetState = sheetState,
                onDismissRequest = { showBottomSheet = false }
            ) {
                Text(
                    "Swipe up to open sheet. Swipe down to dismiss.",
                    modifier = Modifier.padding(16.dp)
                )
            }
        }
    }
}

نکات کلیدی درباره کد

در این مثال، به موارد زیر توجه کنید:

  • showBottomSheet کنترل می‌کند که برنامه برگه پایین را نمایش دهد یا نه.
  • sheetState نمونه‌ای از SheetState است که در آن skipPartiallyExpanded نادرست است.
  • ModalBottomSheet اصلاح‌کننده‌ای دارد که تضمین می‌کند وقتی کاملاً ازهم باز می‌شود، صفحه را پر کند.
  • ModalBottomSheet مقدار sheetState را برای پارامتر sheetState خود درنظر می‌گیرد.
    • درنتیجه، وقتی برگه برای اولین‌بار باز می‌شود، فقط بخشی از آن نمایش داده می‌شود. سپس کاربر می‌تواند آن را بکشد یا تند بکشد تا تمام‌صفحه شود یا آن را ببندد.
  • onDismissRequest lambda کنترل می‌کند که وقتی کاربر سعی می‌کند برگه پایین را ببندد چه اتفاقی می‌افتد. در این حالت، فقط برگه برداشته می‌شود.

نتایج

وقتی کاربر برای اولین‌بار دکمه را فشار می‌دهد، برگه به‌طور جزئی نمایش داده می‌شود:

برگه پایینی که در ابتدا فقط بخشی از صفحه را پر می‌کند. کاربر می‌تواند با تند کشیدن، آن را در کل صفحه نمایش دهد یا آن را ببندد
شکل ۱. برگ زیرین تاحدی نمایش داده شده است.

اگر کاربر روی برگه تند به بالا بکشد، برگه کل صفحه را پر می‌کند:

برگ زیرینی که کاربر آن را گسترده کرده است تا صفحه را پر کند.
شکل ۲. برگ زیرین تمام‌صفحه.

منابع بیشتر