simple_count_down_timer 1.0.9
simple_count_down_timer: ^1.0.9 copied to clipboard
This is a simple countdown timer widget. It displays the remaining time until a specified time, triggers a callback function when the countdown finishes.
Flutter Countdown Timer Widget #
This is a simple countdown timer widget built with Flutter. It displays the remaining time until a specified end date and time, and triggers a callback function when the countdown finishes.
Features #
- Displays remaining time in days, hours, minutes, and seconds.
- Multiple animation styles:
fadeIn,basic,slideUp,scale,flip,rotation, andblur. - Customizable text styles and colors.
- Callback function for when the countdown finishes.
- Lightweight and easy to use.
Installation #
- Add the dependency to your pubspec.yaml file:
simple_count_down_timer: ^1.0.9 # Replace with the latest version
- Run flutter pub get to install the package.
Usage #
import 'package:simple_count_down_timer/simple_count_down_timer.dart' as timer;
void main() {
runApp(const MyApp());
}
class MyApp extends StatefulWidget {
const MyApp({super.key});
@override
State<MyApp> createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
@override
void initState() {
super.initState();
}
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(
title: const Text('Plugin example app'),
),
body: Center(
child: timer.SimpleCountDownTimer(
duration: const Duration(days: 1, seconds: 5),
animationStyle: timer.AnimationStyle.fadeIn,
),
),
),
);
}
}
Animation Styles #
Set the animationStyle property to change how the timer digits animate. Available values from AnimationStyle:
| Style | Description |
|---|---|
fadeIn |
Digits fade in on change (default). |
basic |
No animation, plain text update. |
slideUp |
Digits slide upward on change. |
scale |
Digits scale in/out on change. |
flip |
Digits flip on change. |
rotation |
Digits rotate on change. |
blur |
Digits blur transition on change. |
timer.SimpleCountDownTimer(
duration: const Duration(days: 1, seconds: 5),
animationStyle: timer.AnimationStyle.flip,
)
See the example app for a live picker that previews every style.
Customization #
- TextStyle: You can customize the text style of the countdown timer by setting the style property of the child widget.
- Colors: You can change the colors of the text and background by using a ThemeData with your desired colors.
Additional Notes #
This package is for simple countdown timers. For more advanced features like pausing, resuming, and complex formatting, consider exploring other timer packages available on pub.dev. Make sure to replace ^1.0.8 with the latest version of the countdown_timer package in your pubspec.yaml file.