Flutter 中的 Autocomplete 小部件：全面指南

在 Flutter 中，Autocomplete 是一个文本输入辅助小部件，它可以根据用户输入的内容提供自动完成建议。这在创建搜索栏、填写表单或其他需要快速输入的场景中非常有用。虽然 Flutter 的基础库中没有直接提供 Autocomplete 小部件，但是可以通过组合 TextField 和自定义逻辑来实现。

基础用法

实现 Autocomplete 的基础是 TextField，你还需要监听文本变化并提供建议列表：

class MyAutocomplete extends StatelessWidget {final List<String> suggestions = ['Apple', 'Banana', 'Cherry', 'Date'];@overrideWidget build(BuildContext context) {return TextField(onChanged: (text) {// 当文本改变时，过滤建议列表},decoration: InputDecoration(suffixIcon: Icon(Icons.search),),);}
}

监听文本变化

为了提供自动完成建议，你需要监听 TextField 的 onChanged 回调：

onChanged: (text) {// 根据输入的文本过滤建议列表List<String> filteredSuggestions = suggestions.where((suggestion) {return suggestion.startsWith(text);}).toList();// 更新建议列表状态setState(() {suggestions = filteredSuggestions;});
}

显示建议列表

使用 Overlay 或其他方式显示建议列表，这里使用 ListView 作为示例：

onChanged: (text) {// ... 过滤建议列表的逻辑// 显示建议列表showSuggestions(filteredSuggestions);
}void showSuggestions(List<String> suggestions) {final RenderBox box = context.findRenderObject() as RenderBox;showDialog(context: context,builder: (BuildContext context) {return AlertDialog(content: Container(height: 200.0,child: ListView.builder(itemCount: suggestions.length,itemBuilder: (context, index) {return ListTile(title: Text(suggestions[index]),onTap: () {// 当点击建议项时，填充文本框并关闭建议列表TextField.of(context).controller.text = suggestions[index];Navigator.pop(context);},);},),),);},);
}

自定义建议项

建议项可以是文本，也可以是更复杂的布局：

ListTile(title: Text(suggestions[index]),leading: Icon(Icons.food_bank),onTap: () {/* ... */},
)

实例：完整的 Autocomplete

下面是一个简单的 Autocomplete 实现：

class AutocompleteTextField extends StatefulWidget {@override_AutocompleteTextFieldState createState() => _AutocompleteTextFieldState();
}class _AutocompleteTextFieldState extends State<AutocompleteTextField> {final List<String> _suggestions = ['Apple', 'Banana', 'Cherry', 'Date'];String _text = '';@overrideWidget build(BuildContext context) {return TextField(onChanged: (text) {final pattern = RegExp(text);final filteredSuggestions = _suggestions.where((s) => pattern.hasMatch(s));showSuggestions(filteredSuggestions);},controller: TextEditingController(text: _text),decoration: InputDecoration(hintText: 'Start typing...',suffixIcon: Icon(Icons.search),),);}void showSuggestions(Iterable<String> suggestions) {// 实现显示建议列表的逻辑}
}