Dropdown

💧 A powerful and customizable Compose Multiplatform dropdown menu with cascade and animations.

Demo

Who's using Dropdown?

👉 Check out who's using Dropdown

Features

• 🎨 Rich customization options
• 🌊 Extensive animation library
• 📱 Compose Multiplatform support
• 🎯 Intuitive DSL for menu creation
• 🔄 Cascade menu support
• 🎭 12+ enter/exit animations
• 🎨 Custom theming support

Include in your project

Gradle

Add the dependency below to your module's build.gradle file:

dependencies {
implementation("io.github.androidpoet:dropdown:$version")
}

Kotlin Multiplatform

Add the dependency below to your module's build.gradle.kts file:

sourceSets {
val commonMain by getting {
dependencies {
implementation("io.github.androidpoet:dropdown:$version")
}
}
}

Usage

Create Menu Builder

fungetMenu(): MenuItem<String> {
val menu = dropDownMenu<String> {
item("about", "About") {
icon(Icons.TwoTone.Language)
}
item("copy", "Copy") {
icon(Icons.TwoTone.FileCopy)
}
item("share", "Share") {
icon(Icons.TwoTone.Share)
item("to_clipboard", "To clipboard") {
item("pdf", "PDF")
item("epub", "EPUB")
item("web_page", "Web page")
item("microsoft_word", "Microsoft word")
}
item("as_a_file", "As a file") {
item("pdf", "PDF")
item("epub", "EPUB")
item("web_page", "Web page")
item("microsoft_word", "Microsoft word")
}
}
item("remove", "Remove") {
icon(Icons.TwoTone.DeleteSweep)
item("yep", "Yep") {
icon(Icons.TwoTone.Done)
}
item("go_back", "Go back") {
icon(Icons.TwoTone.Close)
}
}
}
return menu
}

Create Dropdown Menu

@ExperimentalAnimationApi
@Composable
funMenu(isOpen:Boolean = false, setIsOpen: (Boolean) ->Unit, itemSelected: (String) ->Unit) {
val menu = getMenu()
Dropdown(
isOpen = isOpen,
menu = menu,
colors = dropDownMenuColors(Teal200, White),
onItemSelected = itemSelected,
onDismiss = { setIsOpen(false) },
offset =DpOffset(8.dp, 0.dp),
enter =EnterAnimation.ElevationScale,
exit =ExitAnimation.ElevationScale,
easing =Easing.FastOutSlowInEasing,
enterDuration =400,
exitDuration =400
)
}

Supported Animations

Enter Animations

EnterAnimation.FadeInEnterAnimation.SharedAxisXForwardEnterAnimation.SharedAxisYForwardEnterAnimation.SharedAxisZForwardEnterAnimation.ElevationScaleEnterAnimation.SlideInEnterAnimation.SlideInHorizontallyEnterAnimation.SlideInVerticallyEnterAnimation.ScaleInEnterAnimation.ExpandInEnterAnimation.ExpandHorizontallyEnterAnimation.ExpandVertically

Exit Animations

ExitAnimation.FadeOutExitAnimation.SharedAxisXBackwardExitAnimation.SharedAxisYBackwardExitAnimation.SharedAxisZBackwardExitAnimation.ElevationScaleExitAnimation.SlideOutExitAnimation.SlideOutHorizontallyExitAnimation.SlideOutVerticallyExitAnimation.ScaleOutExitAnimation.ShrinkOutExitAnimation.ShrinkHorizontallyExitAnimation.ShrinkVertically

Easing Options

Easing.FastOutSlowInEasingEasing.LinearOutSlowInEasingEasing.FastOutLinearInEasingEasing.LinearEasing

Animation Examples

Fade	SharedAxisX	SharedAxisY	SharedAxisZ
ElevationScale	SlideIn(SlideOut)	SlideHorizontally	SlideVertically
Scale	Expand	Expand Horizontally	Expand Vertically

_{List icons created by Freepik - Flaticon}

Support

Contributing

Contributions are welcome! If you've found a bug, have an idea for an improvement, or want to contribute new features, please open an issue or submit a pull request.

Find this repository useful? ❤️

Support it by joining stargazers for this repository. ⭐
Also, follow me on GitHub for more cool projects! 🤩

License

Copyright 2022 AndroidPoet (Ranbir Singh)
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.