Skip to content

Latest commit

 

History

History
149 lines (117 loc) · 4.76 KB

README.md

File metadata and controls

149 lines (117 loc) · 4.76 KB
Raw

cta_banner

AnimatedBottomBarCompose

AnimatedBottomBarCompose is a Jetpack Compose library that simplifies the creation of stylish Bottom Navigation Bars with customizable animations. It allows you to easily integrate attractive navigation bars into your Android app, enhancing the user experience.

LINE INDICATOR

FILLED INDICATOR

DOT INDICATOR

WORM INDICATOR

Features

  • Multiple Styles: Choose from a variety of pre-defined styles for your Bottom Navigation Bar or create your custom style.
  • Animation Options: Choose from variety of eye-catching animations for your navigation bar elements, making your app more engaging.
  • Customization: Customize colors, icons, and animations to match your app's branding and design.

Configuration

Available on Maven Central.

Add the dependency

    implementation 'com.canopas.compose-animated-navigationbar:bottombar:1.0.1'

Sample Usage

Integrating AnimatedBottomBarCompose into your Android app is a breeze! Follow these simple steps to get started:

  1. First, set up your navigation controller:
val navController = rememberNavController()
val navBackStackEntry by navController.currentBackStackEntryAsState()
val currentRoute = navBackStackEntry?.destination?.route
val navigationItems = MainNavigation::class.nestedClasses.map {
    it.objectInstance as MainNavigation
}
var selectedItem by remember { mutableIntStateOf(0) }
  1. Next, add AnimatedBottomBarCompose to your app's Scaffold as the bottom bar:
Scaffold(
    bottomBar = {
        AnimatedBottomBar(
            selectedItem = selectedItem,
            itemSize = navigationItems.take(3).size,
            containerColor = Color.LightGray,
            indicatorStyle = IndicatorStyle.LINE
        ) {
            navigationItems.forEachIndexed { index, navigationItem ->
                BottomBarItem(
                    selected = currentRoute == navigationItem.route,
                    onClick = {
                        if (currentRoute != navigationItem.route) {
                            selectedItem = index
                            // ... Navigation Stuff
                        }
                    },
                    imageVector = navigationItem.icon,
                    label = navigationItem.title,
                    containerColor = Color.Transparent
                )
            }
        }
    }
) {
// ... (rest of your app content)
}

Demo

To see AnimatedBottomBarCompose in action, check out our Sample app where you can explore various styles and animation options.

Bugs and Feedback

For bugs, questions and discussions please use the Github Issues

Credits

AnimatedBottomBarCompose is owned and maintained by the Canopas team. For project updates and releases, you can follow them on X at @canopas_eng.

Licence

Copyright 2023 Canopas Software LLP

Licensed under the Apache License, Version 2.0 (the "License");
You won't be using 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.