Flutter 倒计时:重复触发与页面生命周期

以短信重发按钮为例,处理计时器重复创建、结束状态和页面退出。

适用版本

原文发布于 2022 年;整理时补齐计时器取消与生命周期处理。

本文目录
  1. 倒计时的状态
  2. 与发送动作连接
  3. 点击节流的范围
  4. 参考

短信重发按钮需要显示剩余等待时间,同时避免重复创建计时器。Timer.periodic 负责刷新界面,结束时间负责计算剩余秒数,页面退出时释放计时器。

倒计时的状态

dart
Timer? _timer;
DateTime? _deadline;
int _remaining = 0;

void startCountdown() {
  _timer?.cancel();
  _deadline = DateTime.now().add(const Duration(seconds: 60));
  _refreshCountdown();
  _timer = Timer.periodic(
    const Duration(seconds: 1),
    (_) => _refreshCountdown(),
  );
}

void _refreshCountdown() {
  if (!mounted || _deadline == null) {
    _timer?.cancel();
    return;
  }
  final milliseconds = _deadline!.difference(DateTime.now()).inMilliseconds;
  final seconds = (milliseconds / 1000).ceil().clamp(0, 60).toInt();
  setState(() => _remaining = seconds);
  if (seconds == 0) _timer?.cancel();
}

@override
void dispose() {
  _timer?.cancel();
  super.dispose();
}

这些成员和方法放在 State 类中,并导入 dart:async。先取消旧计时器,使连续点击或重试不会同时运行多套回调。

与发送动作连接

dart
TextButton(
  onPressed: _remaining > 0 || _sending ? null : sendCode,
  child: Text(_remaining > 0 ? '${_remaining}s 后重发' : '发送验证码'),
)

sendCode 自行管理 _sending,并在服务端确认发送成功后调用 startCountdown。如果服务端返回的是冷却截止时间,显示应使用服务端结果。

周期回调并不保证每次恰好间隔一秒。应用进入后台、事件循环繁忙时,简单执行“减一”会逐渐偏离真实时间。按截止时间重算能减少这类偏差;恢复到前台时也可主动刷新一次。

点击节流的范围

几百毫秒的按钮节流可以用独立的布尔状态和单次 Timer 实现。验证码发送频率与额度必须由服务端控制,本地倒计时只提供界面反馈。

参考

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。