适用版本
原文发布于 2022 年;整理时补齐计时器取消与生命周期处理。
短信重发按钮需要显示剩余等待时间,同时避免重复创建计时器。Timer.periodic 负责刷新界面,结束时间负责计算剩余秒数,页面退出时释放计时器。
倒计时的状态
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。先取消旧计时器,使连续点击或重试不会同时运行多套回调。
与发送动作连接
TextButton(
onPressed: _remaining > 0 || _sending ? null : sendCode,
child: Text(_remaining > 0 ? '${_remaining}s 后重发' : '发送验证码'),
)
sendCode 自行管理 _sending,并在服务端确认发送成功后调用 startCountdown。如果服务端返回的是冷却截止时间,显示应使用服务端结果。
周期回调并不保证每次恰好间隔一秒。应用进入后台、事件循环繁忙时,简单执行“减一”会逐渐偏离真实时间。按截止时间重算能减少这类偏差;恢复到前台时也可主动刷新一次。
点击节流的范围
几百毫秒的按钮节流可以用独立的布尔状态和单次 Timer 实现。验证码发送频率与额度必须由服务端控制,本地倒计时只提供界面反馈。


