├── .github
├── FUNDING.yml
└── ISSUE_TEMPLATE
│ └── bug_report.md
├── .gitignore
├── .metadata
├── CHANGELOG.md
├── LICENSE
├── README-zh.md
├── README.md
├── analysis_options.yaml
├── ci
├── ci-analysis_options.yaml
├── deploy
├── doc
├── app-release-arm64.apk
├── appbar-badge.gif
├── appbar-corner-fixed.png
├── appbar-corner.png
├── appbar-demo.gif
├── appbar-fixed-circle.gif
├── appbar-fixed.gif
├── appbar-flip.gif
├── appbar-gradient.gif
├── appbar-image.gif
├── appbar-react-circle.gif
├── appbar-react.gif
├── appbar-single-button.png
├── appbar-single-shape.png
├── appbar-textIn.gif
├── appbar-theming.png
├── appbar-titled.gif
├── badge-demo-preview.gif
├── badge-demo.mp4
├── donate-kofi1.png
├── donate-wechat.jpeg
├── flutter-favorite.png
├── how-to-block-tab-event.md
├── issue-change-active-tab-index.md
├── issue-crash-on-flutter-dev-channel.md
├── issue-image-for-actionitem.md
├── issue-remove-elevation.md
├── preview.png
├── tab-hook.gif
└── tabcontroller_pageview.gif
├── example
├── .gitignore
├── .metadata
├── README.md
├── android
│ ├── .gitignore
│ ├── app
│ │ ├── build.gradle
│ │ └── src
│ │ │ ├── debug
│ │ │ └── AndroidManifest.xml
│ │ │ ├── main
│ │ │ ├── AndroidManifest.xml
│ │ │ ├── kotlin
│ │ │ │ └── com
│ │ │ │ │ └── example
│ │ │ │ │ └── convexappbar
│ │ │ │ │ └── MainActivity.kt
│ │ │ └── res
│ │ │ │ ├── drawable-v21
│ │ │ │ └── launch_background.xml
│ │ │ │ ├── drawable
│ │ │ │ └── launch_background.xml
│ │ │ │ ├── mipmap-hdpi
│ │ │ │ └── ic_launcher.png
│ │ │ │ ├── mipmap-mdpi
│ │ │ │ └── ic_launcher.png
│ │ │ │ ├── mipmap-xhdpi
│ │ │ │ └── ic_launcher.png
│ │ │ │ ├── mipmap-xxhdpi
│ │ │ │ └── ic_launcher.png
│ │ │ │ ├── mipmap-xxxhdpi
│ │ │ │ └── ic_launcher.png
│ │ │ │ ├── values-night
│ │ │ │ └── styles.xml
│ │ │ │ └── values
│ │ │ │ └── styles.xml
│ │ │ └── profile
│ │ │ └── AndroidManifest.xml
│ ├── build.gradle
│ ├── gradle.properties
│ ├── gradle
│ │ └── wrapper
│ │ │ └── gradle-wrapper.properties
│ └── settings.gradle
├── images
│ ├── sample-1-2.png
│ ├── sample-1.png
│ ├── sample-2-2.png
│ ├── sample-2.png
│ ├── sample-3-2.png
│ ├── sample-3.png
│ ├── sample-4-2.png
│ ├── sample-4.png
│ ├── sample-5-2.png
│ └── sample-5.png
├── ios
│ ├── .gitignore
│ ├── Flutter
│ │ ├── AppFrameworkInfo.plist
│ │ ├── Debug.xcconfig
│ │ └── Release.xcconfig
│ ├── Runner.xcodeproj
│ │ ├── project.pbxproj
│ │ ├── project.xcworkspace
│ │ │ ├── contents.xcworkspacedata
│ │ │ └── xcshareddata
│ │ │ │ ├── IDEWorkspaceChecks.plist
│ │ │ │ └── WorkspaceSettings.xcsettings
│ │ └── xcshareddata
│ │ │ └── xcschemes
│ │ │ └── Runner.xcscheme
│ ├── Runner.xcworkspace
│ │ ├── contents.xcworkspacedata
│ │ └── xcshareddata
│ │ │ ├── IDEWorkspaceChecks.plist
│ │ │ └── WorkspaceSettings.xcsettings
│ └── Runner
│ │ ├── AppDelegate.swift
│ │ ├── Assets.xcassets
│ │ ├── AppIcon.appiconset
│ │ │ ├── Contents.json
│ │ │ ├── Icon-App-1024x1024@1x.png
│ │ │ ├── Icon-App-20x20@1x.png
│ │ │ ├── Icon-App-20x20@2x.png
│ │ │ ├── Icon-App-20x20@3x.png
│ │ │ ├── Icon-App-29x29@1x.png
│ │ │ ├── Icon-App-29x29@2x.png
│ │ │ ├── Icon-App-29x29@3x.png
│ │ │ ├── Icon-App-40x40@1x.png
│ │ │ ├── Icon-App-40x40@2x.png
│ │ │ ├── Icon-App-40x40@3x.png
│ │ │ ├── Icon-App-60x60@2x.png
│ │ │ ├── Icon-App-60x60@3x.png
│ │ │ ├── Icon-App-76x76@1x.png
│ │ │ ├── Icon-App-76x76@2x.png
│ │ │ └── Icon-App-83.5x83.5@2x.png
│ │ └── LaunchImage.imageset
│ │ │ ├── Contents.json
│ │ │ ├── LaunchImage.png
│ │ │ ├── LaunchImage@2x.png
│ │ │ ├── LaunchImage@3x.png
│ │ │ └── README.md
│ │ ├── Base.lproj
│ │ ├── LaunchScreen.storyboard
│ │ └── Main.storyboard
│ │ ├── Info.plist
│ │ └── Runner-Bridging-Header.h
├── lib
│ ├── color_item_view.dart
│ ├── components
│ │ ├── chip_item.dart
│ │ ├── choose_tab_item.dart
│ │ ├── colors_item.dart
│ │ ├── gradient_item.dart
│ │ ├── heading.dart
│ │ └── radio_item.dart
│ ├── convex_button_demo.dart
│ ├── custom_appbar_sample.dart
│ ├── data.dart
│ ├── default_appbar_demo.dart
│ ├── main.dart
│ └── model
│ │ ├── badge.dart
│ │ ├── choice_value.dart
│ │ └── named_color.dart
├── pubspec.yaml
└── web
│ ├── favicon.png
│ ├── icons
│ ├── Icon-192.png
│ └── Icon-512.png
│ ├── index.html
│ └── manifest.json
├── lib
├── convex_bottom_bar.dart
└── src
│ ├── bar.dart
│ ├── chip_builder.dart
│ ├── convex_shape.dart
│ ├── fab.dart
│ ├── interface.dart
│ ├── item.dart
│ ├── painter.dart
│ ├── reused_gradient.dart
│ ├── stack.dart
│ └── style
│ ├── blend_image_icon.dart
│ ├── fixed_circle_tab_style.dart
│ ├── fixed_tab_style.dart
│ ├── flip_tab_style.dart
│ ├── inner_builder.dart
│ ├── internal_style_config.dart
│ ├── react_circle_tab_style.dart
│ ├── react_tab_style.dart
│ ├── styles.dart
│ ├── textin_tab_style.dart
│ ├── titled_tab_style.dart
│ ├── transition_container.dart
│ └── transition_container_builder.dart
├── pubspec.yaml
└── test
├── provider_test.dart
├── utils_test.dart
└── widget_test.dart
/.github/FUNDING.yml:
--------------------------------------------------------------------------------
1 | # These are supported funding model platforms
2 |
3 | github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
4 | patreon: # Replace with a single Patreon username
5 | open_collective: # Replace with a single Open Collective username
6 | ko_fi: hacktons
7 | tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
8 | community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
9 | liberapay: # Replace with a single Liberapay username
10 | issuehunt: # Replace with a single IssueHunt username
11 | otechie: # Replace with a single Otechie username
12 | custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
13 |
--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/bug_report.md:
--------------------------------------------------------------------------------
1 | ---
2 | name: Bug report
3 | about: Create a report to help us improve
4 | title: ''
5 | labels: ''
6 | assignees: ''
7 |
8 | ---
9 |
10 | ## Notice for Stack compile error
11 | ```
12 | * Replace all Stack.overflow to Stack.clipBehavior.
13 | * The removal of [Stack.overflow][https://api.flutter.dev/flutter/widgets/Stack/overflow.html] is not a good idea, and the Flutter team has noticed that it would take time to remove all the usage without breaking Google.
14 | Since the overflow has been removed in 1.20 and be rolled back now(perhaps 1.22? not for sure). It's hard to say when it will be removed again, so just replace all overflow with clipBehavior.
15 | ```
16 | ---
17 |
18 | > Please search the [issue list](https://github.com/hacktons/convex_bottom_bar/issues) and [FAQ list](https://github.com/hacktons/convex_bottom_bar#faq) before opening any issues!!
19 |
20 | **Describe the bug**
21 |
22 | A clear and concise description of what the bug is.
23 |
24 | **Environment details**
25 |
26 | Paste the flutter environment detail.
27 | ```
28 | flutter doctor
29 | flutter --version
30 | ```
31 | Paste the package version.
32 | ```
33 | dependencies:
34 | convex_bottom_bar: x.y.z
35 | ```
36 |
37 | **To Reproduce**
38 |
39 | Steps to reproduce the behavior:
40 | 1. Go to '...'
41 | 2. Click on '....'
42 | 3. Scroll down to '....'
43 | 4. See error
44 |
45 | **Expected behavior**
46 |
47 | A clear and concise description of what you expected to happen.
48 |
49 | **Screenshots**
50 |
51 | If applicable, add screenshots to help explain your problem.
52 |
53 | **Additional context**
54 |
55 | Add any other context about the problem here.
56 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | # Miscellaneous
2 | *.class
3 | *.log
4 | *.pyc
5 | *.swp
6 | .DS_Store
7 | .atom/
8 | .buildlog/
9 | .history
10 | .svn/
11 |
12 | # IntelliJ related
13 | *.iml
14 | *.ipr
15 | *.iws
16 | .idea/
17 |
18 | # The .vscode folder contains launch configuration and tasks you configure in
19 | # VS Code which you may wish to be included in version control, so this line
20 | # is commented out by default.
21 | #.vscode/
22 |
23 | # Flutter/Dart/Pub related
24 | **/doc/api/
25 | .dart_tool/
26 | .flutter-plugins
27 | .packages
28 | .pub-cache/
29 | .pub/
30 | build/
31 | pubspec.lock
32 |
33 | # Android related
34 | **/android/**/gradle-wrapper.jar
35 | **/android/.gradle
36 | **/android/captures/
37 | **/android/gradlew
38 | **/android/gradlew.bat
39 | **/android/local.properties
40 | **/android/**/GeneratedPluginRegistrant.java
41 |
42 | # iOS/XCode related
43 | **/ios/**/*.mode1v3
44 | **/ios/**/*.mode2v3
45 | **/ios/**/*.moved-aside
46 | **/ios/**/*.pbxuser
47 | **/ios/**/*.perspectivev3
48 | **/ios/**/*sync/
49 | **/ios/**/.sconsign.dblite
50 | **/ios/**/.tags*
51 | **/ios/**/.vagrant/
52 | **/ios/**/DerivedData/
53 | **/ios/**/Icon?
54 | **/ios/**/Pods/
55 | **/ios/**/.symlinks/
56 | **/ios/**/profile
57 | **/ios/**/xcuserdata
58 | **/ios/.generated/
59 | **/ios/Flutter/App.framework
60 | **/ios/Flutter/Flutter.framework
61 | **/ios/Flutter/Generated.xcconfig
62 | **/ios/Flutter/app.flx
63 | **/ios/Flutter/app.zip
64 | **/ios/Flutter/flutter_assets/
65 | **/ios/Flutter/flutter_export_environment.sh
66 | **/ios/ServiceDefinitions.json
67 | **/ios/Runner/GeneratedPluginRegistrant.*
68 | **/ios/Podfile.lock
69 |
70 | # Exceptions to above rules.
71 | !**/ios/**/default.mode1v3
72 | !**/ios/**/default.mode2v3
73 | !**/ios/**/default.pbxuser
74 | !**/ios/**/default.perspectivev3
75 | !/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
76 | # Pana report
77 | pana_visual/
78 | coverage/
79 |
--------------------------------------------------------------------------------
/.metadata:
--------------------------------------------------------------------------------
1 | # This file tracks properties of this Flutter project.
2 | # Used by Flutter tool to assess capabilities and perform upgrades etc.
3 | #
4 | # This file should be version controlled and should not be manually edited.
5 |
6 | version:
7 | revision: cc949a8e8b9cf394b9290a8e80f87af3e207dce5
8 | channel: stable
9 |
10 | project_type: package
11 |
--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
1 | ## [3.2.0]
2 | * Support flutter 3.7
3 |
4 | ## [3.1.0+1]
5 | * Format project with `flutter format .`
6 |
7 | ## [3.1.0]
8 | * Bug fix;
9 | * New API to set shadow color
10 | * Fix lint warning
11 |
12 | ## [3.0.0-nullsafety.1]
13 | * Prepare for Flutter 2.
14 |
15 | ## [2.7.1+2]
16 | * format
17 |
18 | ## [2.7.1+1]
19 | * Bug fix [Manual update tab index workaround seems not working since version 2.7.x](https://github.com/hacktons/convex_bottom_bar/issues/134)
20 |
21 | ## [2.7.1]
22 | * fix runtime exception when there is no controller passed in
23 |
24 | ## [2.7.0+1]
25 | * add new configuration `disableDefaultTabController`
26 |
27 | ## [3.0.0-nullsafety.0]
28 |
29 | * Migrate to [null-safety](https://dart.dev/null-safety/migration-guide).
30 |
31 | ## [2.6.0]
32 | * Fix tab highlight state to satisfy keyboard and router case; [#115](https://github.com/hacktons/convex_bottom_bar/issues/115), [#112](https://github.com/hacktons/convex_bottom_bar/issues/112)
33 | * Breaking changes: disable initial index property when working with TabController to avoid potential index conflict;
34 |
35 | ## [2.5.1+1]
36 | * Bug fix [#111 Tab selection not registered during tab transition](https://github.com/hacktons/convex_bottom_bar/issues/111)
37 |
38 | ## [2.5.1]
39 |
40 | * Replace all Stack.overflow to Stack.clipBehavior.
41 | * The removal of [Stack.overflow][https://api.flutter.dev/flutter/widgets/Stack/overflow.html] is not a good idea, and the Flutter team has noticed that it would take time to remove all the usage without breaking Google.
42 | Since the overflow has been removed in 1.20 and be rolled back now(perhaps 1.22? not for sure). It's hard to say when it will be removed again, so just replace all overflow with clipBehavior.
43 |
44 | ## [2.5.0]
45 | * Support hook api for tab event. [How to block tab event?](https://github.com/hacktons/convex_bottom_bar/blob/master/doc/how-to-block-tab-event.md)
46 |
47 | ## [2.4.2]
48 | * Bug fix [#102 dispose is executed more than once](https://github.com/hacktons/convex_bottom_bar/issues/102)
49 | * Set min version of flutter to 1.12.0
50 |
51 | ## [2.4.1]
52 | * Fix badge alignment issues [#77](https://github.com/hacktons/convex_bottom_bar/issues/77).
53 |
54 | ## [2.4.0]
55 | * Support flutter v1.20, the v2.2.4-flutter-1.20 is now sync with v2.4.0.
56 | * Add new feature. We can now add corner on AppBars's background.
57 |
58 | ## [2.3.0]
59 | * Add convex button widget.
60 |
61 | ## [2.2.5+1]
62 |
63 | * fix format issue.
64 | ```
65 | lib/src/bar.dart is not formatted according to dartfmt
66 | To format your files run: dartfmt -w .
67 | ```
68 |
69 | ## [2.2.5]
70 |
71 | * Bug fix [#67](https://github.com/hacktons/convex_bottom_bar/issues/67)
72 |
73 | ## [2.2.4-flutter-1.20]
74 | * support the flutter v1.20
75 | * fix: overflow property of stack deprecated [#60](https://github.com/hacktons/convex_bottom_bar/pull/60)
76 |
77 | ## [2.2.4]
78 | * Polish internal style, avoid reanimate when AppBar rebuild.
79 |
80 | ## [2.2.3]
81 |
82 | * Bug fix [#59](https://github.com/hacktons/convex_bottom_bar/issues/59)
83 | * Bug fix: default index not match with DefaultTabController.
84 |
85 | ## [2.2.2]
86 | * Fix activate index when appbar is not working with controller;
87 | * Dispose AnimationController when is dirty;
88 |
89 | ## [2.2.1]
90 | * Support RTL;
91 |
92 | ## [2.2.0]
93 |
94 | * Add new API to hook internal styles. Checkout `StyleProvider` for details;
95 | * Provide configuration to hide Text widget when label is empty;
96 |
97 | ## [2.1.1]
98 |
99 | * Fix ChipBuilder missing issue;
100 | * Polish ci test;
101 |
102 | ## [2.1.0+1]
103 |
104 | * Document all the public APIs;
105 |
106 | ## [2.1.0]
107 |
108 | * Add controller for Appbar to change tab index programmaticlly;
109 | * Support with framework's DefaultTabController and TabController;
110 | * Enable access to the ConvexAppBarState;
111 | * Fix active tab position when using even menus;
112 |
113 | ## [2.0.3]
114 |
115 | * Fix hitTest for active tab;
116 |
117 | ## [2.0.2]
118 |
119 | * Add new config parameter for initial active index;
120 |
121 | ## [2.0.1]
122 |
123 | * Update usage instructions in README.md；
124 | * Add new test cases to improve the code coverage;
125 | * Bug fix;
126 |
127 | ## [2.0.0]
128 |
129 | * Support badge on tab item;
130 | * Constructor update, rename the builder;
131 | * Bug fix;
132 |
133 | ## [1.4.1]
134 |
135 | * Add titled style;
136 | * Remove some redundant widget layers;
137 |
138 | ## [1.4.0]
139 |
140 | * Add flip style;
141 | * Add textIn style;
142 |
143 | ## [1.3.1+1]
144 |
145 | * Bug fix: activate icon is not working in some style;
146 | * Improvement: enable image with/without color blend;
147 |
148 | ## [1.3.1]
149 |
150 | * Support gradient background;
151 | * Tab item are generic type, both `IconData` and `Widget` can be used;
152 |
153 | ## [1.3.0]
154 |
155 | * Add new tab style;
156 | * Support animated tab transition；
157 |
158 | ## [1.2.0]
159 |
160 | * Support iPhoneX' safe area at bottom edge. [#issues/7](https://github.com/hacktons/convex_bottom_bar/issues/7)
161 |
162 | ## [1.1.0]
163 |
164 | * Add elevation attribute.
165 |
166 | ## [1.0.2+1]
167 |
168 | * Documentation fixes.
169 |
170 | ## [1.0.2]
171 |
172 | * Fix maintenance suggestions to get higher score
173 |
174 | ## [0.0.1]
175 |
176 | * Publish the packages to pub.dev
177 |
178 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "[]"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright [yyyy] [name of copyright owner]
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
--------------------------------------------------------------------------------
/README-zh.md:
--------------------------------------------------------------------------------
1 | 
2 |
3 | 
4 | 
5 | 
6 | 
7 | 
8 | 
9 | 
10 |
11 |
12 | English
13 | | 简体中文
14 |
15 |
16 | ---
17 |
18 | ConvexBottomBar是一个底部导航栏组件，用于展现凸起的TAB效果，支持多种内置样式与动画交互。你可以在[https://appbar.codemagic.app](https://appbar.codemagic.app)上找到在线样例。
19 |
20 | **convex_bottom_bar 现在是一个 [Flutter Favorite](https://flutter.dev/docs/development/packages-and-plugins/favorites) 插件库!**
21 |
22 |
23 | 
24 |
25 |
26 | 以下是一些支持的预定义样式：
27 |
28 | | **fixed** | **react** | **badge chip** |
29 | |:---------------------------------:|:--------------------------------:|:-------------------------:|
30 | |  |  |  |
31 | | **fixedCircle** | **reactCircle** | **flip** |
32 | |  |  |  |
33 | | **textIn** | **titled** | **tab image** |
34 | |  |  |  |
35 | | **button** | **fixed corner** | |
36 | |  |  | |
37 |
38 | ## 快速上手
39 |
40 | 通常ConvexAppBar可以通过设置bottomNavigationBar与Scaffold一起使用。
41 |
42 | ConvexAppBar具有两个构造函数，ConvexAppBar()将使用默认样式来简化选项卡的创建。
43 |
44 | 将此添加到您程序包的pubspec.yaml文件中，注意使用最新版本[](https://pub.dartlang.org/packages/convex_bottom_bar):
45 |
46 | ```yaml
47 | dependencies:
48 | convex_bottom_bar: ^latest_version
49 | ```
50 |
51 | ```dart
52 | import 'package:convex_bottom_bar/convex_bottom_bar.dart';
53 |
54 | Scaffold(
55 | bottomNavigationBar: ConvexAppBar(
56 | items: [
57 | TabItem(icon: Icons.home, title: 'Home'),
58 | TabItem(icon: Icons.map, title: 'Discovery'),
59 | TabItem(icon: Icons.add, title: 'Add'),
60 | TabItem(icon: Icons.message, title: 'Message'),
61 | TabItem(icon: Icons.people, title: 'Profile'),
62 | ],
63 | onTap: (int i) => print('click index=$i'),
64 | )
65 | );
66 | ```
67 |
68 | **Flutter Version Support**
69 | 由于Flutter迭代非常快。SDK本身有可能出现不兼容的API变更，我们将继续支持flutter稳定版本，非稳定的beta、dev channel
70 | 通过单独版本号进行兼容。
71 |
72 | | **Stable Flutter Version** | **Package Version** | **More** |
73 | |:--------------------------:|:-------------------:|:------------------------------------------:|
74 | | >=3.7.0 | >=3.2.0 | 从v3.7.0版本DefaultTabController的API有变更 |
75 | | >=1.20 | >=2.4.0 | 从 v1.20开始, Stack组件的API发送不兼容变更 |
76 | | <1.20 | <2.4.0 | v1.20稳定版发布后，我们对老版本如v1.17, v1.12 的支持将不再继续更新 |
77 |
78 | 如果你只需要一个单独的按钮，不妨试试 `ConvexButton`.
79 |
80 | ## 功能
81 |
82 | * 提供多种内部样式
83 | * 能够更改AppBar的主题
84 | * 提供Builder API以自定义新样式
85 | * 在AppBar上添加徽章
86 | * 支持优雅的过渡动画
87 | * 提供Hook API来重载一些内部样式
88 | * RTL布局支持
89 |
90 | ## Table of contents
91 |
92 | - [主题](#主题)
93 | - [角标](#角标)
94 | - [单独按钮](#单独按钮)
95 | - [样式重载](#样式重载)
96 | - [RTL支持](#RTL支持)
97 | - [自定义样例](#自定义样例)
98 | - [常见问题](#常见问题)
99 | - [支持](#支持)
100 |
101 | ## 角标
102 | 如果需要在TAB上添加徽章/角标，请使用`ConvexAppBar.badge`来构建。
103 |
104 | [](doc/badge-demo.mp4 "badge demo")
105 |
106 | ```dart
107 | ConvexAppBar.badge({0: '99+', 1: Icons.assistant_photo, 2: Colors.redAccent},
108 | items: [
109 | TabItem(icon: Icons.home, title: 'Home'),
110 | TabItem(icon: Icons.map, title: 'Discovery'),
111 | TabItem(icon: Icons.add, title: 'Add'),
112 | ],
113 | onTap: (int i) => print('click index=$i'),
114 | );
115 | ```
116 |
117 | `badge()`方法接受一个角标数组； 角标是带有选项卡项的映射，每个条目的值可以是String，IconData，Color或Widget。
118 |
119 | ## 单独按钮
120 | 
121 |
122 | ```dart
123 | Scaffold(
124 | appBar: AppBar(title: const Text('ConvexButton Example')),
125 | body: Center(child: Text('count $count')),
126 | bottomNavigationBar: ConvexButton.fab(
127 | onTap: () => setState(() => count++),
128 | ),
129 | );
130 | ```
131 |
132 | ## 主题
133 | AppBar默认使用内置样式，您可能需要为其设置主题。 以下是一些支持的属性：
134 |
135 | 
136 |
137 | | Attributes | Description |
138 | |-----------------|--------------------------------------------------------|
139 | | backgroundColor | AppBar 背景 |
140 | | gradient | 渐变属性，可以覆盖backgroundColor |
141 | | height | AppBar 高度 |
142 | | color | icon/text 的颜色值 |
143 | | activeColor | icon/text 的**选中态**颜色值 |
144 | | curveSize | 凸形大小 |
145 | | top | 凸形到AppBar上边缘的距离 |
146 | | style | 支持的样式: **fixed, fixedCircle, react, reactCircle**, ... |
147 | | chipBuilder | 角标构造器builder, **ConvexAppBar.badge**会使用默认样式 |
148 |
149 | ## 样式重载
150 | 重载Tab内置样式。 该API与`ConvexAppBar.builder`不同，为了满足您可能需要更新选项卡样式而不定义新的选项卡样式。
151 | **温馨提示:**
152 | 则此Hook能力是有限的，如果您提供的尺寸与内部样式不匹配，并且可能导致`overflow broken`。
153 |
154 | ```dart
155 | StyleProvider(
156 | style: Style(),
157 | child: ConvexAppBar(
158 | initialActiveIndex: 1,
159 | height: 50,
160 | top: -30,
161 | curveSize: 100,
162 | style: TabStyle.fixedCircle,
163 | items: [
164 | TabItem(icon: Icons.link),
165 | TabItem(icon: Icons.import_contacts),
166 | TabItem(title: "2020", icon: Icons.work),
167 | ],
168 | backgroundColor: _tabBackgroundColor,
169 | ),
170 | )
171 | class Style extends StyleHook {
172 | @override
173 | double get activeIconSize => 40;
174 |
175 | @override
176 | double get activeIconMargin => 10;
177 |
178 | @override
179 | double get iconSize => 20;
180 |
181 | @override
182 | TextStyle textStyle(Color color) {
183 | return TextStyle(fontSize: 20, color: color);
184 | }
185 | }
186 | ```
187 |
188 | ## RTL支持
189 | RTL的内部适配，如果你配置了Directionality，将自动支持ltf和rtl两种布局风格。
190 | ```dart
191 | Directionality(
192 | textDirection: TextDirection.rtl,
193 | child: Scaffold(body:ConvexAppBar(/*TODO ...*/)),
194 | )
195 | ```
196 |
197 | ## 自定义样例
198 |
199 | 如果默认样式与您的情况不符，请尝试使用`ConvexAppBar.builder()`，它可以让您自定义几乎所有TAB样式。
200 | ```dart
201 | Scaffold(
202 | bottomNavigationBar: ConvexAppBar.builder(
203 | count: 5,
204 | backgroundColor: Colors.blue,
205 | itemBuilder: Builder(),
206 | )
207 | );
208 |
209 | /*user defined class*/
210 | class Builder extends DelegateBuilder {
211 | @override
212 | Widget build(BuildContext context, int index, bool active) {
213 | return Text('TAB $index');
214 | }
215 | }
216 | ```
217 |
218 | 完整的自定义示例可以在[example](example)中找到。
219 |
220 | ## 常见问题
221 | 如您在使用过程中有新功能建议或者遇到问题，请移步至[issue tracker](https://github.com/hacktons/convex_bottom_bar/issues)提交。
222 |
223 | * [如何拦截Tab事件](doc/how-to-block-tab-event.md)
224 | * [Flutter dev/beta channel运行崩溃](doc/issue-crash-on-flutter-dev-channel.md)
225 | * [动态修改选中的TAB](doc/issue-change-active-tab-index.md)
226 | * [如何给TAB添加图片而不是ICON](doc/issue-image-for-actionitem.md)
227 | * [如何移除AppBar的边缘阴影](doc/issue-remove-elevation.md)
228 |
229 | ## 支持
230 | 如果对你有帮助，微信扫码请作者喝杯咖啡 :)
231 |
232 | 
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 | English
13 | | 简体中文
14 |
15 |
16 | ---
17 |
18 | The official BottomAppBar can only display a notch FAB with an app bar, and sometimes we need a convex FAB. BottomAppBar and NotchShape's implementation inspires this ConvexAppBar.
19 |
20 | Online example can be found at [https://appbar.codemagic.app](https://appbar.codemagic.app).
21 |
22 | **convex_bottom_bar is now a [Flutter Favorite](https://flutter.dev/docs/development/packages-and-plugins/favorites) package!**
23 |
24 |
25 |
26 |
27 |
28 | Here are some supported style:
29 |
30 | | **fixed** | **react** | **badge chip** |
31 | |:---------------------------------:|:--------------------------------:|:-------------------------:|
32 | |  |  |  |
33 | | **fixedCircle** | **reactCircle** | **flip** |
34 | |  |  |  |
35 | | **textIn** | **titled** | **tab image** |
36 | |  |  |  |
37 | | **button** | **fixed corner** | |
38 | |  |  | |
39 |
40 | ## How to use
41 | Typically ConvexAppBar can work with `Scaffold` by setup its `bottomNavigationBar`.
42 |
43 | The `ConvexAppBar` has two constructors. The `ConvexAppBar()` will use the default style to simplify the tab creation.
44 |
45 | Add this to your package's pubspec.yaml file, use the latest version [](https://pub.dartlang.org/packages/convex_bottom_bar):
46 |
47 | ```yaml
48 | dependencies:
49 | convex_bottom_bar: ^latest_version
50 | ```
51 |
52 | ```dart
53 | import 'package:convex_bottom_bar/convex_bottom_bar.dart';
54 |
55 | Scaffold(
56 | bottomNavigationBar: ConvexAppBar(
57 | items: [
58 | TabItem(icon: Icons.home, title: 'Home'),
59 | TabItem(icon: Icons.map, title: 'Discovery'),
60 | TabItem(icon: Icons.add, title: 'Add'),
61 | TabItem(icon: Icons.message, title: 'Message'),
62 | TabItem(icon: Icons.people, title: 'Profile'),
63 | ],
64 | onTap: (int i) => print('click index=$i'),
65 | )
66 | );
67 | ```
68 |
69 | **Flutter Version Support**
70 | As Flutter is developing fast. There can be breaking changes. We will be trying to support the
71 | stable version and beta version through different package versions.
72 |
73 | | **Stable Flutter Version** | **Package Version** | **More** |
74 | |:--------------------------:|:-------------------:|:--------------------------------------------------------------------------:|
75 | | >=3.7.0 | >=3.2.0 | Since v3.7.0, the stable version changed the DefaultTabController api |
76 | | >=1.20 | >=2.4.0 | Since v1.20, the stable version changed the Stack api |
77 | | <1.20 | <=2.3.0 | Support for stable version such as v1.17, v1.12 is not going to be updated |
78 |
79 | ## Features
80 | * Provide multiple internal styles
81 | * Ability to change the theme of AppBar
82 | * Provide builder API to customize a new style
83 | * Add badge on the tab menu
84 | * Elegant transition animation
85 | * Provide hook API to override some of the internal styles
86 | * RTL support
87 |
88 | ## Table of contents
89 |
90 | - [Theming](#theming)
91 | - [Badge](#badge)
92 | - [Single Button](#single-button)
93 | - [Style Hook](#style-hook)
94 | - [RTL Support](#rtl-support)
95 | - [Custom Example](#custom-example)
96 | - [FAQ](#faq)
97 | - [Donate](#donate)
98 |
99 | ## Theming
100 | The bar will use default style, you may want to theme it. Here are some supported attributes:
101 |
102 | 
103 |
104 | | Attributes | Description |
105 | |-----------------|--------------------------------------------------------------------------------------|
106 | | backgroundColor | AppBar background |
107 | | gradient | gradient will override backgroundColor |
108 | | height | AppBar height |
109 | | color | tab icon/text color |
110 | | activeColor | tab icon/text color **when selected** |
111 | | curveSize | size of the convex shape |
112 | | top | top edge of the convex shape relative to AppBar |
113 | | cornerRadius | draw the background with topLeft and topRight corner; Only work with fixed tab style |
114 | | style | style to describe the convex shape: **fixed, fixedCircle, react, reactCircle**, ... |
115 | | chipBuilder | custom badge builder, use **ConvexAppBar.badge** for default badge |
116 |
117 | ## Badge
118 |
119 | If you need to add a badge on the tab, use the `ConvexAppBar.badge` to get it done.
120 |
121 | [](doc/badge-demo.mp4 "badge demo")
122 |
123 | ```dart
124 | ConvexAppBar.badge({0: '99+', 1: Icons.assistant_photo, 2: Colors.redAccent},
125 | items: [
126 | TabItem(icon: Icons.home, title: 'Home'),
127 | TabItem(icon: Icons.map, title: 'Discovery'),
128 | TabItem(icon: Icons.add, title: 'Add'),
129 | ],
130 | onTap: (int i) => print('click index=$i'),
131 | );
132 | ```
133 |
134 | The `badge()` method accepts an array of badges; The `badges` is a map with tab items. Each value of entry can be either `String`, `IconData`, `Color` or `Widget`.
135 |
136 | ## Single Button
137 |
138 | If you only need a single button, checkout the `ConvexButton`.
139 |
140 | 
141 |
142 | ```dart
143 | Scaffold(
144 | appBar: AppBar(title: const Text('ConvexButton Example')),
145 | body: Center(child: Text('count $count')),
146 | bottomNavigationBar: ConvexButton.fab(
147 | onTap: () => setState(() => count++),
148 | ),
149 | );
150 | ```
151 |
152 | ## Style Hook
153 | Hook for internal tab style. Unlike the `ConvexAppBar.builder`, you may want to update the tab style without defining a new tab style.
154 |
155 | **Warning:**
156 | This hook is limited and can lead to `overflow broken` if the size you provide does not match with internal style.
157 |
158 | ```dart
159 | StyleProvider(
160 | style: Style(),
161 | child: ConvexAppBar(
162 | initialActiveIndex: 1,
163 | height: 50,
164 | top: -30,
165 | curveSize: 100,
166 | style: TabStyle.fixedCircle,
167 | items: [
168 | TabItem(icon: Icons.link),
169 | TabItem(icon: Icons.import_contacts),
170 | TabItem(title: "2020", icon: Icons.work),
171 | ],
172 | backgroundColor: _tabBackgroundColor,
173 | ),
174 | )
175 | class Style extends StyleHook {
176 | @override
177 | double get activeIconSize => 40;
178 |
179 | @override
180 | double get activeIconMargin => 10;
181 |
182 | @override
183 | double get iconSize => 20;
184 |
185 | @override
186 | TextStyle textStyle(Color color) {
187 | return TextStyle(fontSize: 20, color: color);
188 | }
189 | }
190 | ```
191 |
192 | ## RTL Support
193 | RTL is supported internally, and if you define the TextDirection inside the app, the AppBar should work fine.
194 | Both RTL and LTR can be configured through `Directionality`:
195 | ```dart
196 | Directionality(
197 | textDirection: TextDirection.rtl,
198 | child: Scaffold(body:ConvexAppBar(/*TODO ...*/)),
199 | )
200 | ```
201 |
202 | ## Custom Example
203 |
204 | If the default style does not match your situation, try with `ConvexAppBar.builder()`, allowing you to custom nearly all the tab features.
205 |
206 | ```dart
207 | Scaffold(
208 | bottomNavigationBar: ConvexAppBar.builder(
209 | count: 5,
210 | backgroundColor: Colors.blue,
211 | itemBuilder: Builder(),
212 | )
213 | );
214 |
215 | // user defined class
216 | class Builder extends DelegateBuilder {
217 | @override
218 | Widget build(BuildContext context, int index, bool active) {
219 | return Text('TAB $index');
220 | }
221 | }
222 | ```
223 |
224 | Full custom example can be found at [example](example).
225 |
226 | ## FAQ
227 | Please file feature requests and bugs at the [issue tracker](https://github.com/hacktons/convex_bottom_bar/issues).
228 |
229 | * [How to block tab event?](doc/how-to-block-tab-event.md)
230 | * [Crash on flutter dev/beta channel](doc/issue-crash-on-flutter-dev-channel.md)
231 | * [Change active tab index programmatically](doc/issue-change-active-tab-index.md)
232 | * [Using an image instead of an icon for actionItem](doc/issue-image-for-actionitem.md)
233 | * [Is there anyway to remove elevation in the bottom bar?](doc/issue-remove-elevation.md)
234 |
235 | ## Donate
236 | You like the package ? Buy me a coffee :)
237 |
238 | [](https://ko-fi.com/hacktons)
239 |
--------------------------------------------------------------------------------
/analysis_options.yaml:
--------------------------------------------------------------------------------
1 | # Defines a default set of lint rules enforced for
2 | # projects at Google. For details and rationale,
3 | # see https://github.com/dart-lang/pedantic#enabled-lints.
4 | include: package:pedantic/analysis_options.yaml
5 |
6 | linter:
7 | rules:
8 | - public_member_api_docs
9 | analyzer:
10 | exclude:
11 | - example/**
12 | - test/**
13 |
--------------------------------------------------------------------------------
/ci:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env bash
2 | ##################################################################
3 | ##
4 | ## Test case for CI building
5 | ##
6 | ##
7 | ## Author: Chaobin Wu
8 | ## Email : chaobinwu89@gmail.com
9 | ##
10 | #################################################################
11 | tag='[CI]'
12 | error() {
13 | echo -e "\033[1m$tag\033[0m \033[31m$*\033[0m"
14 | }
15 | info() {
16 | echo -e "\033[1m$tag\033[0m \033[32m$*\033[0m"
17 | }
18 | warning() {
19 | echo -e "\033[1m$tag\033[0m \033[33m$*\033[0m"
20 | }
21 |
22 | die() {
23 | error "$*"
24 | exit 1
25 | }
26 | info "Step 1 Run custom lint rules"
27 | dart analyze lib ci-analysis_options.yaml >build/lint-result.txt
28 | # n lints found. => issue found, No issues found! => success
29 | count=$(grep -c 'lints found.' Original designed for [#issue 98](https://github.com/hacktons/convex_bottom_bar/issues/98)
8 |
9 | ## Sample
10 | 
11 |
12 | ```dart
13 | DefaultTabController(
14 | length: items.length,
15 | child: Scaffold(
16 | appBar: AppBar(title: const Text('Custom ConvexAppBar')),
17 | body: TabBarView(
18 | physics: NeverScrollableScrollPhysics(),
19 | children: items.map((i) => Center(child: Text(i.title))).toList(),
20 | ),
21 | bottomNavigationBar: ConvexAppBar(
22 | style: TabStyle.fixedCircle,
23 | items: [
24 | TabItem(title: '2019', icon: Icons.link),
25 | TabItem(
26 | icon: Container(
27 | decoration: BoxDecoration(
28 | shape: BoxShape.circle,
29 | color: Color(0xFFFF5722),
30 | ),
31 | child: Icon(Icons.add, color: Colors.white, size: 40),
32 | )),
33 | TabItem(title: "2020", icon: Icons.work),
34 | ],
35 | onTabNotify: (i) {
36 | var intercept = i == 1;
37 | if (intercept) {
38 | Navigator.pushNamed(context, '/fab');
39 | }
40 | return !intercept;
41 | },
42 | onTap: (i) => debugPrint('click $i'),
43 | ),
44 | ))
45 | ```
46 |
--------------------------------------------------------------------------------
/doc/issue-change-active-tab-index.md:
--------------------------------------------------------------------------------
1 | # Change active tab index programmaticlly
2 |
3 | There ae some cases that you may want to change the activate tab index;
4 | * define a custom initial index
5 | * change index according to PageView/TabBarView
6 |
7 | ## Change initial index
8 |
9 | The `ConvexAppbar` are exposed with `initialActivieIndex`, this value will be used when the appbar are constructed.
10 |
11 | ## Work with PageView/TabBarView
12 | The TabBarView use PageView internal, both support swipe gesture to change current page content;
13 |
14 | 
15 |
16 | ConvexAppBar can work with `TabController` similar with `TabBar`;
17 |
18 | In order to change the index of tab item, config the AppBar with instance of `TabController`; To simplify the code, you can use `DefaultTabController`:
19 |
20 | **Example 1**
21 | ```dart
22 | DefaultTabController(
23 | length: 5,
24 | child: Scaffold(
25 | appBar: AppBar(title: const Text('Custom ConvexAppBar')),
26 | body: TabBarView(
27 | children: ['A','B','C','D','E']
28 | .map((i) => Center(child: Text('$i')))
29 | .toList(growable: false),
30 | ),
31 | bottomNavigationBar: ConvexAppBar(/* some config*/),
32 | ),
33 | );
34 | ```
35 |
36 | **Example 2**
37 | ```dart
38 | Scaffold(
39 | appBar: AppBar(title: const Text('Custom ConvexAppBar')),
40 | body: TabBarView(
41 | controller: _tabController,
42 | children: ['A','B','C','D','E']
43 | .map((i) => Center(child: Text('$i')))
44 | .toList(growable: false),
45 | ),
46 | bottomNavigationBar: ConvexAppBar(controller: _tabController/* some config*/),
47 | );
48 | ```
49 | ## The raw way
50 | If you don't use TabController at all, then you have to update tab index manually through `ConvexAppBarState`.
51 | This usually requires a defined `GlobalKey` set with `ConvexAppBar`:
52 |
53 | ```dart
54 | // define field instance
55 | GlobalKey _appBarKey = GlobalKey();
56 | // construct with key
57 | ConvexAppBar(key: _appBarKey, /* ... */);
58 | // access related State when necessary such as onPageChanged
59 | _appBarKey.currentState.animateTo(2/* index*/);
60 | ```
--------------------------------------------------------------------------------
/doc/issue-crash-on-flutter-dev-channel.md:
--------------------------------------------------------------------------------
1 | # Crash on Flutter dev/beta channel
2 |
3 | As Flutter is developing fast. There can be breaking changes, we will trying to support the
4 | stable version and beta version through different package version.
5 |
6 | If you're using unstable Flutter channel, please follow the table bellow to use the proper package version.
7 |
8 | | **Stable Flutter Version** | **Package Version** | **More** |
9 | | :------------------------: | :-----------------: | :----------------------------------------------------------: |
10 | | >=1.20 | >=2.4.0 | Since v1.20, the stable version changed the Stack api |
11 | | <1.20 | <=2.3.0 | Support for stable version such as v1.17, v1.12 is not going to be updated |
--------------------------------------------------------------------------------
/doc/issue-image-for-actionitem.md:
--------------------------------------------------------------------------------
1 | # Using an image instead of an icon for actionItem
2 |
3 | `TabItem` support both IconData and Widget.
4 |
5 | ```dart
6 | TabItem(icon: Image.asset('images/sample.png'), title: 'Discovery'),
7 | ```
--------------------------------------------------------------------------------
/doc/issue-remove-elevation.md:
--------------------------------------------------------------------------------
1 | # Is there anyway to remove elevation in the bottom bar
2 |
3 | You can remove the shadow by set elevation to 0.
4 |
5 | ```dart
6 | ConvexAppBar(elevation: 0);
7 | ```
8 |
9 |
--------------------------------------------------------------------------------
/doc/preview.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/hacktons/convex_bottom_bar/ddb58b0216eee90c3e88f36eda58d1ba1646ce96/doc/preview.png
--------------------------------------------------------------------------------
/doc/tab-hook.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/hacktons/convex_bottom_bar/ddb58b0216eee90c3e88f36eda58d1ba1646ce96/doc/tab-hook.gif
--------------------------------------------------------------------------------
/doc/tabcontroller_pageview.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/hacktons/convex_bottom_bar/ddb58b0216eee90c3e88f36eda58d1ba1646ce96/doc/tabcontroller_pageview.gif
--------------------------------------------------------------------------------
/example/.gitignore:
--------------------------------------------------------------------------------
1 | # Miscellaneous
2 | *.class
3 | *.log
4 | *.pyc
5 | *.swp
6 | .DS_Store
7 | .atom/
8 | .buildlog/
9 | .history
10 | .svn/
11 |
12 | # IntelliJ related
13 | *.iml
14 | *.ipr
15 | *.iws
16 | .idea/
17 |
18 | # The .vscode folder contains launch configuration and tasks you configure in
19 | # VS Code which you may wish to be included in version control, so this line
20 | # is commented out by default.
21 | #.vscode/
22 |
23 | # Flutter/Dart/Pub related
24 | **/doc/api/
25 | .dart_tool/
26 | .flutter-plugins
27 | .packages
28 | .pub-cache/
29 | .pub/
30 | /build/
31 |
32 | # Android related
33 | **/android/**/gradle-wrapper.jar
34 | **/android/.gradle
35 | **/android/captures/
36 | **/android/gradlew
37 | **/android/gradlew.bat
38 | **/android/local.properties
39 | **/android/**/GeneratedPluginRegistrant.java
40 |
41 | # iOS/XCode related
42 | **/ios/**/*.mode1v3
43 | **/ios/**/*.mode2v3
44 | **/ios/**/*.moved-aside
45 | **/ios/**/*.pbxuser
46 | **/ios/**/*.perspectivev3
47 | **/ios/**/*sync/
48 | **/ios/**/.sconsign.dblite
49 | **/ios/**/.tags*
50 | **/ios/**/.vagrant/
51 | **/ios/**/DerivedData/
52 | **/ios/**/Icon?
53 | **/ios/**/Pods/
54 | **/ios/**/.symlinks/
55 | **/ios/**/profile
56 | **/ios/**/xcuserdata
57 | **/ios/.generated/
58 | **/ios/Flutter/App.framework
59 | **/ios/Flutter/Flutter.framework
60 | **/ios/Flutter/Generated.xcconfig
61 | **/ios/Flutter/app.flx
62 | **/ios/Flutter/app.zip
63 | **/ios/Flutter/flutter_assets/
64 | **/ios/Flutter/flutter_export_environment.sh
65 | **/ios/ServiceDefinitions.json
66 | **/ios/Runner/GeneratedPluginRegistrant.*
67 |
68 | # Exceptions to above rules.
69 | !**/ios/**/default.mode1v3
70 | !**/ios/**/default.mode2v3
71 | !**/ios/**/default.pbxuser
72 | !**/ios/**/default.perspectivev3
73 | !/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
74 |
75 | pubspec.lock
--------------------------------------------------------------------------------
/example/.metadata:
--------------------------------------------------------------------------------
1 | # This file tracks properties of this Flutter project.
2 | # Used by Flutter tool to assess capabilities and perform upgrades etc.
3 | #
4 | # This file should be version controlled and should not be manually edited.
5 |
6 | version:
7 | revision: cc949a8e8b9cf394b9290a8e80f87af3e207dce5
8 | channel: stable
9 |
10 | project_type: app
11 |
--------------------------------------------------------------------------------
/example/README.md:
--------------------------------------------------------------------------------
1 | # convex_bottom_bar_example
2 |
3 | Demonstrates how to use the convex_bottom_bar plugin.
4 |
5 | ## Getting Started
6 |
7 | This project is a starting point for a Flutter application.
8 |
9 | A few resources to get you started if this is your first Flutter project:
10 |
11 | - [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
12 | - [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
13 |
14 | For help getting started with Flutter, view our
15 | [online documentation](https://flutter.dev/docs), which offers tutorials,
16 | samples, guidance on mobile development, and a full API reference.
17 |
--------------------------------------------------------------------------------
/example/android/.gitignore:
--------------------------------------------------------------------------------
1 | gradle-wrapper.jar
2 | /.gradle
3 | /captures/
4 | /gradlew
5 | /gradlew.bat
6 | /local.properties
7 | GeneratedPluginRegistrant.java
8 |
9 | # Remember to never publicly share your keystore.
10 | # See https://flutter.dev/docs/deployment/android#reference-the-keystore-from-the-app
11 | key.properties
12 | **/*.keystore
13 | **/*.jks
14 |
--------------------------------------------------------------------------------
/example/android/app/build.gradle:
--------------------------------------------------------------------------------
1 | def localProperties = new Properties()
2 | def localPropertiesFile = rootProject.file('local.properties')
3 | if (localPropertiesFile.exists()) {
4 | localPropertiesFile.withReader('UTF-8') { reader ->
5 | localProperties.load(reader)
6 | }
7 | }
8 |
9 | def flutterRoot = localProperties.getProperty('flutter.sdk')
10 | if (flutterRoot == null) {
11 | throw new GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
12 | }
13 |
14 | def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
15 | if (flutterVersionCode == null) {
16 | flutterVersionCode = '1'
17 | }
18 |
19 | def flutterVersionName = localProperties.getProperty('flutter.versionName')
20 | if (flutterVersionName == null) {
21 | flutterVersionName = '1.0'
22 | }
23 |
24 | apply plugin: 'com.android.application'
25 | apply plugin: 'kotlin-android'
26 | apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
27 |
28 | android {
29 | compileSdkVersion flutter.compileSdkVersion
30 | ndkVersion flutter.ndkVersion
31 |
32 | compileOptions {
33 | sourceCompatibility JavaVersion.VERSION_1_8
34 | targetCompatibility JavaVersion.VERSION_1_8
35 | }
36 |
37 | kotlinOptions {
38 | jvmTarget = '1.8'
39 | }
40 |
41 | sourceSets {
42 | main.java.srcDirs += 'src/main/kotlin'
43 | }
44 |
45 | defaultConfig {
46 | // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
47 | applicationId "com.example.convexappbar"
48 | // You can update the following values to match your application needs.
49 | // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-build-configuration.
50 | minSdkVersion flutter.minSdkVersion
51 | targetSdkVersion flutter.targetSdkVersion
52 | versionCode flutterVersionCode.toInteger()
53 | versionName flutterVersionName
54 | }
55 |
56 | buildTypes {
57 | release {
58 | // TODO: Add your own signing config for the release build.
59 | // Signing with the debug keys for now, so `flutter run --release` works.
60 | signingConfig signingConfigs.debug
61 | }
62 | }
63 | }
64 |
65 | flutter {
66 | source '../..'
67 | }
68 |
69 | dependencies {
70 | implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
71 | }
72 |
--------------------------------------------------------------------------------
/example/android/app/src/debug/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
3 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/example/android/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
3 |
7 |
15 |
19 |
23 |
24 |
25 |
26 |
27 |
28 |
30 |
33 |
34 |
35 |
--------------------------------------------------------------------------------
/example/android/app/src/main/kotlin/com/example/convexappbar/MainActivity.kt:
--------------------------------------------------------------------------------
1 | package com.example.convexappbar
2 |
3 | import io.flutter.embedding.android.FlutterActivity
4 |
5 | class MainActivity: FlutterActivity() {
6 | }
7 |
--------------------------------------------------------------------------------
/example/android/app/src/main/res/drawable-v21/launch_background.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |