Flutter倒计时进度指示器插件countdown_progress_indicator的使用

Countdown Progress Indicator

countdown_progress_indicator是一个为Flutter提供的可定制化倒计时进度指示器。

Getting Started

要在项目中使用此插件，首先需要在pubspec.yaml文件中添加依赖：

dependencies:
  ...
  countdown_progress_indicator: ^0.1.2

然后，在Dart代码中导入此包：

import 'package:countdown_progress_indicator/countdown_progress_indicator.dart';

How to use

CountDownProgressIndicator小部件默认情况下会自动开始倒计时，并且支持暂停和恢复操作。如果要实现这些功能，则需要使用CountdownController来控制。下面是一个简单的例子，它创建了一个20秒的倒计时进度指示器：

SizedBox(
  height: 200,
  width: 200,
  child: CountDownProgressIndicator(
    controller: _controller, // 使用控制器
    valueColor: Colors.red, // 进度条颜色
    backgroundColor: Colors.blue, // 背景颜色
    initialPosition: 0, // 初始位置
    duration: 20, // 倒计时时长（秒）
    text: 'SEC', // 显示文本
    onComplete: () => null, // 完成后的回调
  ),
),

Custom Formatter

如果你想要显示不同于秒数的文字，可以实现自定义的时间格式化器。例如，将时间格式化为hh:mm:ss的形式：

CountDownProgressIndicator(
  controller: _controller,
  valueColor: Colors.red,
  backgroundColor: Colors.blue,
  initialPosition: 0,
  duration: 365,
  timeFormatter: (seconds) {
    return Duration(seconds: seconds)
        .toString()
        .split('.')[0]
        .padLeft(8, '0');
  },
  text: 'hh:mm:ss',
  onComplete: () => null,
),

示例demo

以下是一个完整的示例应用，展示了如何使用countdown_progress_indicator包创建两个倒计时进度指示器，并提供了暂停/继续按钮来控制它们：

import 'package:countdown_progress_indicator/countdown_progress_indicator.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool _isRunning = true;
  final _controller = CountDownController();
  final _controller2 = CountDownController();

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Container(
          color: Colors.white,
          child: Center(
            child: Column(
              mainAxisSize: MainAxisSize.min,
              children: [
                SizedBox(
                  height: 200,
                  width: 200,
                  child: CountDownProgressIndicator(
                    controller: _controller,
                    valueColor: Colors.red,
                    backgroundColor: Colors.blue,
                    initialPosition: 0,
                    duration: 365,
                    timeFormatter: (seconds) {
                      return Duration(seconds: seconds)
                          .toString()
                          .split('.')[0]
                          .padLeft(8, '0');
                    },
                    text: 'hh:mm:ss',
                    onComplete: () => null,
                  ),
                ),
                const SizedBox(height: 20),
                SizedBox(
                  height: 200,
                  width: 200,
                  child: CountDownProgressIndicator(
                    controller: _controller2,
                    valueColor: Colors.red,
                    backgroundColor: Colors.blue,
                    initialPosition: 0,
                    duration: 365,
                    text: 'Seg',
                    onComplete: () => null,
                  ),
                ),
                const SizedBox(height: 20),
                ElevatedButton(
                  onPressed: () => setState(() {
                    if (_isRunning) {
                      _controller.pause();
                      _controller2.pause();
                    } else {
                      _controller.resume();
                      _controller2.resume();
                    }

                    _isRunning = !_isRunning;
                  }),
                  child: Text(_isRunning ? 'Pause' : 'Resume'),
                )
              ],
            ),
          ),
        ),
      ),
    );
  }
}

这个示例程序创建了两个倒计时进度指示器，每个都设置为365秒（即6分钟零5秒），并且提供了一个按钮用于暂停或恢复所有倒计时。通过点击按钮，用户可以在运行和暂停状态之间切换。