跨平台开发 / 系统课时
为搜索输入增加防抖
为搜索输入增加防抖
搜索框会随着用户输入不断触发变化事件,如果每次按键都发送网络请求,会造成大量无效请求并增加服务器压力。本篇实现 Flutter 搜索输入防抖,让接口只在用户停止输入一段时间后执行,提高搜索体验和请求效率。
学习目标
- 理解搜索场景中的防抖机制
- 使用 Timer 实现输入事件延迟执行
- 在 Flutter 中安全管理搜索请求触发逻辑
搜索请求为什么需要防抖
用户输入关键词时,输入框变化通常非常频繁。例如输入 flutter 时,会连续产生多个状态变化:
f → fl → flu → flut → flutt → flutter
如果每次变化都调用接口,前几个请求大概率没有意义,而且可能造成返回顺序混乱:旧关键词请求晚返回,覆盖了最新搜索结果。
防抖的思路是等待用户停止输入后再执行请求。如果等待时间内再次输入,则取消之前的等待任务。
使用 Timer 实现防抖
Flutter 中可以使用 dart:async 提供的 Timer 管理延迟任务。
下面示例展示一个搜索控制器,输入变化后等待 <TIME> 毫秒再执行搜索。
dart
import 'dart:async';
class SearchController {
Timer? _debounceTimer;
void onSearchChanged(String keyword) {
_debounceTimer?.cancel();
_debounceTimer = Timer(
const Duration(milliseconds: 500),
() {
search(keyword);
},
);
}
Future<void> search(String keyword) async {
if (keyword.isEmpty) {
return;
}
print('request keyword: $keyword');
}
void dispose() {
_debounceTimer?.cancel();
}
}预期输出
text
用户输入:
f
fl
flu
flutter
500ms 内没有继续输入
request keyword: flutter在输入框中接入防抖逻辑
文本输入组件只负责监听变化,将搜索调度交给控制器处理,可以避免页面代码承担请求细节。
dart
TextField(
onChanged: controller.onSearchChanged,
decoration: const InputDecoration(
hintText: '搜索内容',
),
)预期结果
text
输入框变化
→ onChanged 接收新文本
→ 取消旧 Timer
→ 创建新的 Timer
→ 用户停止输入后发送一次请求防抖实现中的注意事项
防抖只能减少请求次数,不能替代请求状态管理。真实网络搜索通常还需要结合请求取消或请求序号校验,避免旧请求覆盖新结果。
还需要注意:
- 页面销毁时取消 Timer,避免触发已释放对象
- 防抖时间需要根据业务调整,通常几百毫秒即可
- 空关键词可以直接清空结果,不必发送接口请求
防抖适合处理连续输入事件,例如搜索、筛选、自动补全等场景。当事件频率高但最终结果只需要最后一次时,防抖可以有效降低无效计算和网络开销。
按自己的节奏,确认真正理解。