跨平台开发 / 系统课时

完成任务列表和详情页面

完成任务列表和详情页面

本节将完成综合应用中的任务浏览流程,通过列表展示任务数据,使用卡片提升信息层次,并利用 Flutter 路由实现从列表进入详情页面的完整交互。

学习目标

  • 掌握使用 ListView 和 Card 组合展示任务集合数据的方法。
  • 理解页面跳转时如何传递对象数据。
  • 完成任务列表页到详情页的实际应用流程。

设计任务列表页面结构

任务列表页面通常负责展示多个任务的摘要信息,不直接承载所有字段。常见做法是使用 ListView.builder 根据数据动态生成列表项,每个列表项通过 Card 包裹,让任务标题、状态等信息保持清晰。

一个简单的任务模型可以只包含页面需要的数据:

dart
class Task {
  final String title;
  final String description;
  final bool completed;

  Task({
    required this.title,
    required this.description,
    required this.completed,
  });
}

列表页需要持有任务集合,并将每个任务转换为可点击的视觉组件。点击后不再重新查询数据,而是直接把当前任务对象传递给详情页。

使用 ListView 展示任务卡片

下面是一个可运行的列表页面片段示例,依赖 Flutter Material 环境和已有 Task 模型。

dart
import 'package:flutter/material.dart';

class TaskListPage extends StatelessWidget {
  final List<Task> tasks;

  const TaskListPage({super.key, required this.tasks});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('任务列表')),
      body: ListView.builder(
        itemCount: tasks.length,
        itemBuilder: (context, index) {
          final task = tasks[index];

          return Card(
            child: ListTile(
              title: Text(task.title),
              subtitle: Text(task.description),
              trailing: Icon(
                task.completed ? Icons.check : Icons.pending,
              ),
              onTap: () {
                Navigator.push(
                  context,
                  MaterialPageRoute(
                    builder: (_) => TaskDetailPage(task: task),
                  ),
                );
              },
            ),
          );
        },
      ),
    );
  }
}

预期结果

text
应用启动后显示任务列表,每个任务以卡片形式展示。
点击任意任务后进入对应详情页面,并显示该任务的数据。

创建任务详情页面

详情页的职责是展示单个任务的完整信息,因此通常接收列表页传入的数据,而不是重新维护一份任务状态。

dart
class TaskDetailPage extends StatelessWidget {
  final Task task;

  const TaskDetailPage({super.key, required this.task});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(task.title)),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(task.description),
            const SizedBox(height: 12),
            Text(task.completed ? '已完成' : '进行中'),
          ],
        ),
      ),
    );
  }
}

预期结果

text
详情页面顶部显示任务标题,页面正文显示描述和完成状态。
返回按钮可以返回任务列表页面。

处理列表和详情页的数据关系

实际项目中,列表页和详情页通常共享同一个数据来源。小型应用可以直接传递对象,大型应用则可能传递任务 ID,再由状态管理层或数据层加载详情。

直接传对象适合数据量较小、页面关系简单的场景;传递 ID 更适合需要刷新、缓存和远程请求的应用。

完成这一部分后,应用已经具备从任务集合浏览到单项查看的核心导航能力,可以继续扩展新增、编辑等任务管理功能。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成任务列表和详情页面

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

登录哪都通