跨平台开发 / 系统课时

搭建搜索和筛选页面

搭建搜索和筛选页面

本篇将完成一个常见的 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:负责空状态展示。

这种方式可以让搜索页从简单查询扩展到电商筛选、内容检索等复杂场景。

搜索和筛选页面的核心是让布局结构跟随业务状态变化,而不是把所有内容固定排列。合理拆分区域后,后续增加排序、分页或联想搜索时都能保持代码清晰。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建搜索和筛选页面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通