Rolling Bottom Bar
This packages, based on this demo by Kabo showing a bottom bar with a dynamic ball indicator.
New Features 💥 (1.1.0)
itemSpacing(RollingItemSpacing.sm,.md,.lg) to change the spacing between items
1.0.0
activeIndexto control the bar without aPageController(the ball animates by itself)topRadiusandbottomRadiusto customize the bar cornerselevationto customize the shadowitemSize(RollingItemSize.sm,.md,.lg) to change the ball and items size- Requires Dart 3 / Flutter 3.10 or higher
Demo
Instalation
Include rolling_bottom_bar in your pubspec.yaml file:
dependencies:
flutter:
sdk: flutter
rolling_bottom_bar: ^1.1.0
Usage
To use this package, just import it into your file and build your bottom bar. You can drive it with a PageController (the ball follows the swipe of a PageView) or with an activeIndex.
With a PageController
import 'package:rolling_bottom_bar/rolling_bottom_bar.dart';
import 'package:rolling_bottom_bar/rolling_bottom_bar_item.dart';
...
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('Rolling Bottom Bar'),
),
body: PageView(
controller: _controller,
children: <Widget>[
ColoredBox(color: Colors.blueGrey.shade100),
ColoredBox(color: Colors.redAccent),
ColoredBox(color: Colors.greenAccent),
ColoredBox(color: Colors.yellowAccent),
],
),
extendBody: true,
bottomNavigationBar: RollingBottomBar(
controller: _controller,
items: [
RollingBottomBarItem(Icons.home, label: 'Page 1'),
RollingBottomBarItem(Icons.star, label: 'Page 2'),
RollingBottomBarItem(Icons.person, label: 'Page 3'),
RollingBottomBarItem(Icons.access_alarm, label: 'Page 4'),
],
activeItemColor: Colors.green.shade700,
enableIconRotation: true,
onTap: (index) {
_controller.animateToPage(
index,
duration: const Duration(milliseconds: 400),
curve: Curves.easeOut,
);
},
),
);
}
}
...
With an active index
int _index = 0;
...
bottomNavigationBar: RollingBottomBar(
activeIndex: _index,
itemSize: RollingItemSize.md,
itemSpacing: RollingItemSpacing.lg,
topRadius: 12,
bottomRadius: 20,
elevation: 8,
items: const [
RollingBottomBarItem(Icons.home, label: 'Page 1'),
RollingBottomBarItem(Icons.star, label: 'Page 2'),
RollingBottomBarItem(Icons.person, label: 'Page 3'),
],
onTap: (index) => setState(() => _index = index),
),
Options for Rolling Bottom Bar Item use
| Name | Description | Required | Default |
|---|---|---|---|
| iconData | IconData to use as item icon | True | |
| label | String to use as label item | False | |
| activeColor | Color to use when icon is active. Only works with useActiveColorByDefault property of RollingBottomBar set on false | False | Colors.green |
Options for Rolling Bottom Bar use
| Name | Description | Required | Default |
|---|---|---|---|
| controller | PageView controller to use to move between pages. If set, activeIndex is ignored |
False | |
| activeIndex | Index of the active item, used when controller is null |
False | 0 |
| items | List of RollingBottomBarItem to render into bottom bar | True | |
| onTap | Function triggered when an item is tapped | True | |
| color | Color value to use as background | False | Colors.white |
| itemColor | Color value to use with inactive items | False | Colors.grey700 |
| activeItemColor | Color value to use with active items | False | Colors.green |
| enableIconRotation | Boolean value to indicate when rotation effect is triggered | False | false |
| flat | Boolean value to indicate if the bottom bar has shadow or not | False | false |
| useActiveColorByDefault | Boolean value to indicate when to use individual active color for each child | False | true |
| topRadius | Radius for the top corners of the bar | False | 10.0 |
| bottomRadius | Radius for the bottom corners of the bar | False | 28.0 |
| elevation | Elevation of the bar shadow. Ignored when flat is true |
False | 5.0 |
| itemSize | Size of the ball and items: RollingItemSize.sm (22), .md (26) or .lg (30) |
False | RollingItemSize.lg |
| itemSpacing | Spacing between items: RollingItemSpacing.sm (closer), .md or .lg (farther apart) |
False | RollingItemSpacing.md |