跨平台开发 / 系统课时
搭建搜索和筛选页面
搭建搜索和筛选页面
本篇将完成一个常见的 Flutter 业务页面组合:顶部搜索框、筛选条件区域、结果列表和空状态展示。通过合理拆分布局结构,让搜索页面能够适应数据变化和交互扩展。
学习目标
- 理解搜索页面中多个区域的布局职责和组合方式。
- 使用 Flutter 组件完成搜索、筛选、列表和空状态结构。
- 掌握根据数据状态切换页面内容的实现方法。
分析搜索页面的布局结构
搜索页面通常不是一个单独组件,而是多个区域组合而成。顶部负责输入关键词,中间负责筛选条件,主体展示搜索结果,结果为空时显示反馈信息。
常见结构可以拆分为:
- 搜索区域:使用
TextField或封装后的搜索组件。 - 筛选区域:使用
Wrap、ChoiceChip等组件展示可选条件。 - 结果区域:使用
ListView或分页列表展示数据。 - 空状态区域:根据查询结果显示提示和操作入口。
这种拆分方式可以避免把所有布局逻辑堆积在一个 build 方法中。
使用组件组合实现页面
下面示例实现一个基础搜索页面。示例中的数据来自内存列表,实际项目中可以替换为接口请求结果。
dart
import 'package:flutter/material.dart';
class SearchPage extends StatefulWidget {
const SearchPage({super.key});
@override
State<SearchPage> createState() => _SearchPageState();
}
class _SearchPageState extends State<SearchPage> {
final TextEditingController controller = TextEditingController();
String keyword = '';
String category = '全部';
final List<String> items = [
'Flutter 布局基础',
'Flutter 状态管理',
'移动端性能优化',
];
@override
Widget build(BuildContext context) {
final results = items
.where((item) => item.contains(keyword))
.toList();
return Scaffold(
appBar: AppBar(title: const Text('搜索')),
body: Column(
children: [
Padding(
padding: const EdgeInsets.all(16),
child: TextField(
controller: controller,
decoration: const InputDecoration(
hintText: '输入关键词',
prefixIcon: Icon(Icons.search),
),
onChanged: (value) {
setState(() => keyword = value);
},
),
),
Wrap(
spacing: 8,
children: ['全部', '文章', '视频'].map((value) {
return ChoiceChip(
label: Text(value),
selected: category == value,
onSelected: (_) {
setState(() => category = value);
},
);
}).toList(),
),
Expanded(
child: results.isEmpty
? const Center(child: Text('没有找到相关内容'))
: ListView.builder(
itemCount: results.length,
itemBuilder: (context, index) {
return ListTile(title: Text(results[index]));
},
),
),
],
),
);
}
}预期结果
text
页面显示搜索输入框、筛选选项和结果列表。
输入关键词后,列表内容会根据匹配结果更新。
没有匹配数据时显示“没有找到相关内容”。处理搜索页面的状态变化
搜索页面的难点通常不是布局,而是状态和布局之间的关系。页面需要根据不同状态展示不同内容。
| 状态 | 页面表现 |
|---|---|
| 初始状态 | 展示默认推荐内容或空列表 |
| 搜索中 | 保留输入区域,展示加载状态 |
| 有结果 | 展示结果列表 |
| 无结果 | 展示空状态提示 |
实际项目中,可以将搜索状态单独抽离为模型,例如使用状态管理方案维护关键词、筛选条件、加载状态和结果数据。
优化页面扩展能力
当筛选条件增加时,不建议直接修改大量布局代码。可以将筛选项抽成独立组件,例如:
SearchBar:处理输入和清除操作。FilterPanel:负责筛选条件展示。ResultList:负责列表渲染。EmptyView:负责空状态展示。
这种方式可以让搜索页从简单查询扩展到电商筛选、内容检索等复杂场景。
搜索和筛选页面的核心是让布局结构跟随业务状态变化,而不是把所有内容固定排列。合理拆分区域后,后续增加排序、分页或联想搜索时都能保持代码清晰。
按自己的节奏,确认真正理解。