persistent_bottom_nav_bar 6.2.1
persistent_bottom_nav_bar: ^6.2.1 copied to clipboard
A highly customizable persistent/static bottom navigation bar for flutter. Includes up-to 20 styles.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
6.2.1 - 2024-07-12 #
- Fixed
nullerror aroundrouteAndNavigatorSettings.
6.2.0 - 2024-07-11 #
- Breaking Changes
- For
PersistentTabView.custom,List<Widget> screenshas been replaced withList<CustomNavBarScreen> screens. - Property
routeAndNavigatorSettingshas been removed fromPersistentTabView.custom. You now defineRouteAndNavigatorSettingsfor each screen separately inCustomNavBarScreen. Please refer to the Readme file for more instructions.
- For
6.1.1 - 2024-07-11 #
- Updated README.md
6.1.0 - 2024-07-11 #
- Fixed issue where class
CustomWidgetRouteAndNavigatorSettingswas unintentionally made private. - Breaking Changes
- To import the package, you will now have to use
import "package:persistent_bottom_nav_bar/persistent_bottom_nav_bar.dart";instead ofimport "package:persistent_bottom_nav_bar/persistent_tab_view.dart";.
- To import the package, you will now have to use
6.0.2 - 2024-07-11 #
- Fixed issues reported by
flutter analyze.
6.0.1 - 2024-07-11 #
- Removed deprecated classes.
- Fixed unwanted trigger of
onWillPopwhen Android back button is pressed. - Fixed the bug where bar in
Style3andStyle4would not work correctly when margin was applied. - Fixed typos in Readme and Changelog.
- Updated example project to run on latest Android versions.
6.0.0 - 2024-07-11 #
- There are many new features and some breaking changes introduced in this version. I will do my best to list all down here but I will still advise to check the example project to cover and see all of the changes for yourself.
- Breaking Changes
NavBarPaddingis replaced withEdgeInsetsin thepaddingproperty.itemAnimationPropertiesandscreenTransitionAnimationare now part of propertyanimationSettings.- Renamed
confineInSafeAreatoconfineToSafeArea. - Removed redundant properties
popAllScreensOnTapOfSelectedTabandpopAllScreensOnTapAnyTabs. Added new propertypopBehaviorOnSelectedNavBarItemPressto cover this behavior. - Property
hideNavigationBaris replaced withisVisible.
- New Features
- Updated maximum supported Flutter SDK version.
- Animated icons are now supported.
- Hiding of navigation bar on scroll down motion is now supported through property
hideOnScrollSettings. Hiding animation settings can be controlled fromanimationSettings. Please check the readme file and example project for better understanding. - You can now scroll to top on a scrollable screen when an already selected navigation bar tab is pressed. You will need to provide scroll controllers in both this and above mentioned functionality.
- New
fadeInanimation inscreenTransitionAnimation. - New function
popUntilFirstScreenOnSelectedTabScreenintroduced inPersistentNavBarNavigator. - If opacity is less than 1 in
PersistentBottomNavBarItemandboxShadowis appliedNavBarDecoration,backgroundColorwill be set to transparent to achieve partial transparent navigation bar effect like on Spotify Android.
- Bug Fixes
- Fixed null errors around
NavBarDecoration. - Removed jitter in animation when property
hideNavigationBarwas changed. - Fixed error -> The getter 'backgroundColor' isn't defined for the type 'ThemeData'.
- Fixed the issue where wrong animation state was shown when
initialIndexonPersistentTabControllerwas other than 0 instyle19. floatingActionButtonis now fixed above the screens instead of separate button for each screen.
- Fixed null errors around
5.0.2 - 2022-09-16 #
- Fixed onWillPop assert error
5.0.1 - 2022-09-16 #
- Fixed linting and formatting errors
5.0.0 - 2022-09-16 #
- Added style 19
- Fixed warnings introduced after Flutter 3.0
- Breaking Changes
- Navigator functions will now be called like
PersistentNavBarNavigator.pushNewScreen(...)instead ofpushNewScreen(..).
- Navigator functions will now be called like
4.0.2 - 2021-03-27 #
- Fixed error while pushing new screens through the included Navigator functions.
4.0.1 - 2021-03-27 #
- Fixed type cast error with
NavigatorObserver.
4.0.0 - 2021-03-22 #
- Null safety migration.
3.2.0 - 2021-03-21 #
inactiveIconis now available inPersistentBottomNavBarItem.- Fixed the bug where all screens of a tab would be popped while switching between tabs.
- Bug fixes.
- Breaking Changes
onWillPopfunction now will return the selected screen's context. PersistentBottomNavBarItemrouteAndNavigatorSettingshas been removed for non-custom navigation bar. Instead, you must now declarerouteAndNavigatorSettingsinPersistentBottomNavBarItem.activeColoris nowactiveColorPrimary.inactiveColoris nowinactiveColorPrimary.activeColorAlternateis nowactiveColorSecondary.onPressednow returns context of the selected screen.
3.1.0 - 2020-12-06 #
- Argument
routeAndNavigatorSettingsadded to handleNavigator.pushNamed(context, 'routeName'). Please define your routes and other navigator settings like navigator observers here as well. - Breaking Changes
- Arguments
initalRoute,navigatorObserversandnavigatorKeysremoved and shifted torouteAndNavigatorSettings.
- Arguments
3.0.0 - 2020-12-06 #
- Added new arguments
navigatorObserversandnavigatorKeysfor the main navigation bar widget. - No need to call
setStatewhen updating active tab using the PersistentTabController. - Function argument
selectedTabScreenContextexposescontextof the selected tab. - Bug fixes and code refactoring.
- Breaking Changes
contextis now required in the constructor.- For custom widget, use this constructor
PersistentTabView.custom(). NavBarStyle.customhas been removed. Please usePersistentTabView.custom().- Argument
iconSizehas been shifted to PersistentBottomNavBarItem. - PersistentBottomNavBarItem argument
activeContentColor's name has been changed toactiveColorSecondary. Functionality remains the same. - PersistentBottomNavBarItem argument
titleStyle's name has been changed totextStyle. Functionality remains the same.
2.1.0 - 2020-10-02 #
- Added
TextStyleproperty for title in the PersistentBottomNavBarItem. - Added
marginproperty for the navigation bar. - Bug fixes.
2.0.5 - 2020-07-16 #
- Bug fixes related to decoration border.
2.0.4 - 2020-07-16 #
- Bug fixes.
2.0.3 - 2020-07-16 #
- Bug fixes.
2.0.2 - 2020-07-15 #
- Fixed
hideNavigationBaranimation jitter and updated Readme.
2.0.1 - 2020-07-15 #
- README updated.
2.0.0 - 2020-07-15 #
These are not all the changes introduced in this update. Only the major ones. They were simply too many and couldn't be listed down here #
- Added transition animations to the Navigator functions.
- Padding simplified into a single property and uses
NavBarPaddinginstead of EdgeInsets. - New property called 'decoration' where are decoration related properties have been moved like curveRadius, boxShadow etc.
- New property to hide the Navigation Bar when keyboard appears.
- For those wanting to display a custom dialog when user tries to exit the app on Android only, use
onWillPopthe callback function. - 8 new styles added.
- Animation properties for all styles can now be controlled through the property
itemAnimationProperties. - Ability to turn off state management.
- Screen transition animation added. Can be controlled with the property
screenTransitionAnimation. - Ability to use custom behavior on tapping of a navigation bar's tab/item through
onPressedcallback method in thePersistentBottomNavBarItem. - Removed
platformSpecificproperty from Navigator functions to make it compatible with Flutter-Web. - Minor new features, bug fixes and stability improvements.
1.5.5 - 2020-05-11 #
- Added property
bottomScreenPaddingto control a screen's bottom padding. - Added property
navBarCurveRadiusto change the nav bar curve's radius. - Added property
popAllScreensOnTapOfSelectedTabto toggle between the ability to pop all pushed screens of a particular selected tab on the second press of the said tab.
1.5.4 - 2020-05-07 #
- Fixed background shadow issue when translucency was turned on with
showElevation == true.
1.5.3 - 2020-05-07 #
- Updated Readme file.
1.5.2 - 2020-05-07 #
- Fixed nav bar background color consistency when translucency enabled.
- Added an example for the navigator function
pushDynamicScreenin the sample project. - Minor improvements to some styles.
1.5.1 - 2020-04-30 #
- Reverted changes to
PersistentTabController.
1.5.0 - 2020-04-30 #
- Added feature to pop back to first screen on tapping of an already selected tab.
- Fixed the issue when new tab was added dynamically.
- Fixed safe area issues.
- Removed property
selectedIndexas it was redundant. UsePersistentTabControllerto control it instead.Breaking Change - Bug fixes.
1.4.5 - 2020-04-29 #
- Fixed nav bar translucency for provided styles.
1.4.4 - 2020-04-29 #
- Updated dependencies.
- Removed
allCornersvalue fromNavBarCurveas it became redundant after a fix.
1.4.1 - 2020-04-29 #
- Improvements to readme.
1.4.0 - 2020-04-29 #
- Implemented handling of the Android back button.
- Fixed the issue where the app would not close at all on Android back button press.
- Updated navigation bar height to give it the default platform look.
- Updated styles to fix the issue where a tap would not be registered.
1.3.0 - 2020-04-25 #
- Incorporated the much requested ability to customize your own bottom navigation bar widget.
- Android's back button will no longer close the app.
1.2.1 - 2020-03-23 #
- Fixed centering of label text in style 1, 7, 9 and 10.
1.2.0 - 2020-03-20 #
- Added
navBarHeightandfloatingActionWidgetproperties, some bug fixes and (BREAKING CHANGE)isCurvedproperty is now replaced withnavBarCurvewhich acceptsNavBarCurve.
1.1.5 - 2020-03-04 #
- Fixed issue for style 6 and 8 where a tap would not be registered occasionally.
1.1.4 - 2020-03-03 #
- Bug fixes and improvements for style 6 and 8.
1.1.3 - 2020-03-02 #
- Bug fixes.
1.1.2 - 2020-03-01 #
- Updated project description.
1.1.1 - 2020-03-01 #
- Memory leakage improvements.
1.1.0 - 2020-03-01 #
- Added
Neumorphicdesign for the navigation bar. - Scale animations for style 7 and 8.
- More control over translucency.
- Bug fixes and improvements.
1.0.15 - 2020-01-27 #
- bug fixes.
1.0.14 - 2020-01-27 #
- Fixed
showElevationinvisible shadow issue.
1.0.13 - 2020-01-27 #
- bug fixes.
1.0.12 - 2020-01-27 #
- Increased space between icon and text for most styles (can be reverted by the use of
bottomPaddingproperty).
1.0.11 - 2020-01-27 #
- bug fixes.
1.0.10 - 2020-01-26 #
- bug fixes.
1.0.9+2 - 2020-01-26 #
- transparency color improvements.
1.0.9+1 - 2020-01-26 #
- bug fixes.
1.0.9 - 2020-01-26 #
- Added
isTranslucentproperty forPersistentBottomNavBarItem. - Tweaked
style8andstyle9's magnification.
1.0.8 - 2020-01-24 #
- Fixed error thrown if
onItemSelectedwas not declared. - Wrapped screens with
Materialfor material elements.
1.0.7+4 - 2020-01-23 #
- Updated README file.
1.0.7+3 - 2020-01-20 #
- Updated
style10's andstyle7's shadow.
1.0.7+2 - 2020-01-20 #
- Updated
style10's andstyle7's shadow.
1.0.7+1 - 2020-01-20 #
- Updated
style10's borders.
1.0.7 - 2020-01-20 #
- Updated
style8's text magnification and added newstyle10.
1.0.6+1 - 2020-01-20 #
- Updated navigator functions' arguments
BREAKING CHANGE.
1.0.6 - 2020-01-20 #
- Updated navigator functions' arguments and added a new nav bar style.
1.0.5 - 2020-01-18 #
- Updated return type of navigator functions.
1.0.4 - 2020-01-16 #
- Added function for pushing
modalscreens.
1.0.3+5 - 2020-01-16 #
- Updated style8's magnification.
1.0.3+4 - 2020-01-16 #
- Updated navigator functions.
- Added another style for the nav bar.
- Added
horizontalPaddingproperty for the nav bar.
1.0.3+3 - 2020-01-10 #
- Fixed issue with
bottomPadding.
1.0.3+2 - 2020-01-09 #
- Updated
pushNewScreenfunctions.
1.0.3+1 - 2020-01-09 #
- Updated project description.
1.0.3 - 2020-01-09 #
- Updated font sizes. Added 'bottomPadding` property for navigation bar items.
1.0.2+1 - 2020-01-09 #
- Fixes in
pushNewScreen.
1.0.2 - 2020-01-09 #
- Fixes in
pushNewScreen.
1.0.1 - 2020-01-09 #
- Updated package's description.
1.0.0 - 2020-01-09 #
- Stable version released.
0.0.5 - 2020-01-09 #
- Fixed formatting.
0.0.4 - 2020-01-09 #
- Example project added to repository.
0.0.3 - 2020-01-08 #
- Updated README.md
0.0.2 - 2020-01-08 #
- Updated README.md
0.0.1 - 2020-01-08 #
Added #
- Persistent Bottom Navigation.
- Ability to push new screen with or without bottom navigation bar.
- 8 styles for the bottom navigation bar (includes BottomNavyBar style).
- Includes function for pushing screen with or without the bottom navigation bar i.e. pushNewScreen() and pushNewScreenWithRouteSettings().
- Includes platform specific behavior as an option (specify it in the two navigator functions).
- Based on flutter's Cupertino(iOS) bottom navigation bar.