Animated Overflow Progress Bar

A customizable animated progress bar widget for Flutter applications, featuring overflow indication.

Features

• Smooth animation when progress changes
• Customizable colors for background, progress, and overflow
• Overflow indication with customizable striped pattern
• Flexible sizing options
• Customizable border radius

Screenshots

Getting started

Add this to your package's pubspec.yaml file:

dependencies:
  animated_overflow_progress_bar: ^1.0.1

Usage

import 'package:animated_overflow_progress_bar/animated_overflow_progress_bar.dart';

AnimatedOverflowProgressBar(
  total: 100,
  progress: 75,
  width: 300,
  height: 30,
  animationDuration: Duration(milliseconds: 500),
  backgroundColor: Colors.grey[200]!,
  progressColor: Colors.blue,
  overflowColor: Colors.grey[100]!,
  borderColor: Colors.black,
  borderRadius: BorderRadius.circular(15),
  overflowTheme: OverflowTheme(
    stripeColor: Colors.red,
    stripeWidth: 0.75,
    stripeSpacing: 5.0,
  ),
)

Customizing Border Radius

You can customize the border radius of the progress bar using the borderRadius property:

// Fully rounded corners
borderRadius: BorderRadius.circular(15)

// Only round the left side
borderRadius: BorderRadius.only(
  topLeft: Radius.circular(15),
  bottomLeft: Radius.circular(15),
)

// Custom radius for each corner
borderRadius: BorderRadius.only(
  topLeft: Radius.circular(10),
  topRight: Radius.circular(20),
  bottomLeft: Radius.circular(30),
  bottomRight: Radius.circular(40),
)

Overflow Indication

When the progress exceeds the total value, the widget automatically displays an overflow section with customizable striped pattern. This makes it easy to visualize when a limit has been exceeded.

Example

For a complete example of how to use this widget, check out the example folder in this repository. It contains a full Flutter project demonstrating the usage of AnimatedOverflowProgressBar.

To run the example:

1. Clone this repository
2. Navigate to the example directory
3. Run flutter pub get
4. Run flutter run

Additional information

For more information on how to use this package, please refer to the API documentation or visit the GitHub repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.