Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ltdangkhoa/flutter-animation-progress-bar
Flutter Animation Progress Bar
https://github.com/ltdangkhoa/flutter-animation-progress-bar
dart flutter-package mobile-development
Last synced: 24 days ago
JSON representation
Flutter Animation Progress Bar
- Host: GitHub
- URL: https://github.com/ltdangkhoa/flutter-animation-progress-bar
- Owner: ltdangkhoa
- License: bsd-3-clause
- Created: 2019-03-19T04:38:11.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-10-12T10:36:55.000Z (about 2 years ago)
- Last Synced: 2024-10-01T16:39:47.126Z (about 1 month ago)
- Topics: dart, flutter-package, mobile-development
- Language: Dart
- Homepage:
- Size: 3.02 MB
- Stars: 85
- Watchers: 2
- Forks: 30
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## Flutter Animation Progress Bar
This colorful [Flutter](https://flutter.io) widget package aims to show an animation progress bar in reactive style. It also supports both vertical and horizontal bar.
### Flutter Create Contest
This package is also a submission to Flutter Create contest. The basic rule of this contest is to measure the total Dart file size less or equal 5KB.
After unzipping the compressed file, run following command to update dependencies:
```
flutter packages get
```
To evaluate the total size of all Dart files:
```
find . -name "*.dart" ! -name "*test*" | xargs cat | wc -c
```
To evaluate only the package Dart code:
```
find . -name "*.dart" ! -name "*test*" ! -path "*example*" | xargs cat | wc -c
```
To run simple example app with a total size of dart code less or equal 5KB:
```
cd example
flutter clean
flutter run
```
Hot restart app with "R" to replay the animation
To run the full example app:
```
cd example
mv lib/main.dart tmp && mv lib/main.dart.bk lib/main.dart && mv tmp lib/main.dart.bk
flutter clean
flutter run
```
Using built-in float action buttons to change value and see the effect
### Getting Started
In order to use this package, do import
```dart
import 'package:flutter_animation_progress_bar/flutter_animation_progress_bar.dart';
```
Basic implementation can be done like below code:
```dart
import 'package:flutter/widgets.dart';
import 'package:flutter_animation_progress_bar/flutter_animation_progress_bar.dart';
void main() {
runApp(
Center(
child: FAProgressBar(
currentValue: 80,
displayText: '%',
)),
);
}
```
### Example App
You can find more examples from [Example App](example)
### API
In this table, you can find all attributes provided by this package:
| Attribute | Default value | Description |
| ------------------- | --------------------------------- | ----------- |
| currentValue | 0 | Set the current value for progress bar. This value should be in **stateful** so that whenever **setState()** has been called, the progress bar will trigger an animation from **latest currentValue** to **new currentValue** |
| maxValue | 100 | Max value to be displayed as progress bar.
*Current value can be greater than max value* |
| size | 30 | The bar height if direction in Axis.horizontal.
The bar width if direction in Axis.vertical |
| animatedDuration | const Duration(milliseconds: 300) | Set the duration for an animation cycle |
| direction | Axis.horizontal | The bar can be in **Axis.horizontal** or **Axis.vertical** direction |
| verticalDirection | VerticalDirection.down | With vertical direction, the bar can be **VerticalDirection.up** or **VerticalDirection.down** direction|
| borderRadius | 8 | Set the bar border radius |
| border | ```null``` | Set the bar border style by **BoxBorder** |
| backgroundColor | const Color(0x00FFFFFF) | Set the bar background color |
| progressColor | const Color(0xFFFA7268) | Set the bar progressing color |
| progressGradient | ```null``` | Set the bar progressing gradient. Overrides `progressColor` |
| changeColorValue | ```null``` | Set a value that progress color should be changed to
[0---blue----[**70**]-red-100] |
| changeProgressColor | const Color(0xFF5F4B8B) | Color that progressing color will be changed to, whenever **currentValue** greater than **changeColorValue** |
| displayText | ```null``` | Text to display belonging with currentValue.
Examples:
```%``` -> ```20%```
```°F``` -> ```80°F```|
| displayTextStyle | ... | TextStyle of displayText|
### Objects
```dart
class FAProgressBar {
final double currentValue;
final double maxValue;
final double size;
final Duration animatedDuration;
final Axis direction;
final VerticalDirection verticalDirection;
final double borderRadius;
final BoxBorder border;
final Color backgroundColor;
final Color progressColor;
final Gradient progressGradient;
final int changeColorValue;
final Color changeProgressColor;
final String displayText;
final TextStyle displayTextStyle;
}
```
### Feedback
Feel free to [leave any feedback](https://github.com/ltdangkhoa/Flutter-Animation-Progress-Bar/issues) for helping support this package 🍻
[](https://www.buymeacoffee.com/13f742 "Buy Me A Coffee")