Category Navigator #

A flutter ui package for cool navigation bar with a lot of customization options

Features #

• navigation bar customization like color, elevation, shape, border radius, axis, etc
• unselected and highlighted item customization like background color, text color, shape, shadow, elevation, etc
• animate to default active item
• can use icons, or labels, or both

Check out changelog for updates on features and fixes.

Getting started #

To start using this package, add category_navigator dependency to your pubspec.yaml

dependencies:
    category_navigator: "<latest_release>"

Usage #

Here's a basic example to get started with the package.

final List<String> itemsList = const ['All', 'Android', 'ML', 'Python', 'Flutter', 'Text', 'iOS', 'Web', 'Windows'];

@override
Widget build(BuildContext context) {
return Scaffold(
    body: SafeArea(
        child: Padding(
            padding: const EdgeInsets.all(8.0),
            child: CategoryNavigator(
              items: itemsList,
              navigatorController: NavigatorController(),
              scrollController: ScrollController(),
              onChange: (value) {}
            )
        )
    ));
}

To get the navigator's current position at any time, initialize an object using NavigatorController(), pass the controller object to navigatorController parameter of the constructor and then use _navigatorController.activeItemIndex to get the selected item's index

Take a look at code examples.

CategoryNavigator parameters #

labels and icons paramters both cannot be null, you have to provide atleast one of them. Additional parameters include all the parameters of CategoryNavigatorItem class. See CategoryNavigatorItem parameters for more details.

CategoryNavigatorItem parameters #

labels and iconData paramters both cannot be null, you have to provide atleast one of them.

TODO #

• Fix vertical navigation bar
• working on passing complete widgets as items

Bugs or Requests #

If you encounter any problems feel free to open an issue. If you feel the library is missing a feature, please raise a ticket on GitHub and I'll look into it. Pull request are also welcome.

License #

category_navigator is licensed under MIT license. View license.