Simplifies navigation in Compose projects using Material3 BottomSheets as routes, reducing dependencies and ensuring consistent Material3 experience. Supports customization of bottom sheet appearance.
This library provides a navigation solution for Compose multiplatform projects using Material3 BottomSheets. It allows you to define your BottomSheet as navigation routes, eliminating the need for the material
library. This simplifies your app's dependencies and ensures a consistent Material3 experience.
You can follow the implementation approach used in the app module. Alternatively, you can find a detailed explanation below.
The library is now available on MavenCentral!!!
Add the dependencies to your libs.versions.toml
[versions]
...
navigationCompose="2.8.0-alpha08"
material3Navigation = "X.X.X" #follow the release version
[libraries]
...
navigation-compose = { module = "org.jetbrains.androidx.navigation:navigation-compose", version.ref = "navigationCompose" }
material3-navigation = { group = "io.github.stefanoq21", name = "material3-navigation-kmp", version.ref = "material3Navigation" }
In your build.gradle.kts implement your dependencies:
...
dependencies {
...
implementation(compose.material3)
implementation(libs.navigation.compose)
implementation(libs.material3.navigation)
Define your BottomSheetNavigator
...
val bottomSheetNavigator =
rememberBottomSheetNavigator(skipPartiallyExpanded = true/false)
val navController = rememberNavController(bottomSheetNavigator)
Add the ModalBottomSheetLayout on top of the NavHost component and pass the bottomSheetNavigator as parameter:
ModalBottomSheetLayout(
modifier = Modifier
.fillMaxSize(),
bottomSheetNavigator = bottomSheetNavigator
) {
NavHost(
navController = navController,
startDestination = Screen.Home
) {
...
Define your routes as strings or data class (depend on the compose navigation version you are using):
...
bottomSheet<Screen.BottomSheetFullScreen> {
BSFullScreenLayout()
}
bottomSheet("BottomSheetFullScreen") {
BSFullScreenLayout()
}
...
Everything is ready! Just navigate to your new destination as usual:
...
Button(onClick = { navController.navigate(Screen.BottomSheetFullScreen) }) {
Text(text = "BottomSheetFullScreen")
}
...
The library currently supports the same customization options of the standard androidx.compose.material3.ModalBottomSheet. You can customize the appearance of the all the bottomsheets used in your navigation graph by passing the parameters to the ModalBottomSheetLayout.
We welcome contributions to this library! If you have bug reports, feature requests, or code improvements, please feel free to create a pull request. I appreciate your help in making this library even better.
Copyright 2024 stefanoq21
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Surfaced from shared tags and platforms — no rankings paid for.