跨平台开发 / 系统课时

用 Checkbox 和 Switch 处理选择

用 Checkbox 和 Switch 处理选择

本篇介绍 Flutter 中两类常见布尔状态控件:Checkbox 和 Switch。通过理解状态管理方式,可以实现设置页面、协议勾选、功能开关等常见交互。

学习目标

  • 理解 Checkbox 与 Switch 的使用场景差异。
  • 掌握通过状态变量控制选择状态。
  • 能够实现响应用户操作的布尔状态更新。

认识选择型控件的状态模型

Checkbox 和 Switch 都用于表达只有两个结果的状态,例如是否同意协议、是否开启通知。它们本身不会自动保存业务状态,而是通过 onChanged 回调通知外部,由开发者更新状态。

Flutter 推荐使用单向数据流方式管理这类控件:状态保存在 State 中,控件根据状态渲染,用户操作后通过回调修改状态。

Checkbox 更适合表示多个选项中的选择关系,例如兴趣标签、权限列表。Switch 更接近系统设置中的开关,用于表示某项功能是否启用。

使用 Checkbox 实现勾选状态

下面示例创建一个同意协议的复选框。

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

class AgreementWidget extends StatefulWidget {
  const AgreementWidget({super.key});

  @override
  State<AgreementWidget> createState() => _AgreementWidgetState();
}

class _AgreementWidgetState extends State<AgreementWidget> {
  bool accepted = false;

  @override
  Widget build(BuildContext context) {
    return CheckboxListTile(
      title: const Text('同意用户协议'),
      value: accepted,
      onChanged: (value) {
        setState(() {
          accepted = value ?? false;
        });
      },
    );
  }
}

预期结果

text
初始显示未勾选状态。
点击复选框后状态变为勾选。
再次点击后恢复未勾选状态。

使用 Switch 控制功能开关

Switch 的逻辑与 Checkbox 类似,但表达含义更偏向“开启”和“关闭”。例如设置页面中的深色模式、消息通知等功能。

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

class NotificationSetting extends StatefulWidget {
  const NotificationSetting({super.key});

  @override
  State<NotificationSetting> createState() => _NotificationSettingState();
}

class _NotificationSettingState extends State<NotificationSetting> {
  bool enabled = true;

  @override
  Widget build(BuildContext context) {
    return SwitchListTile(
      title: const Text('接收通知'),
      value: enabled,
      onChanged: (value) {
        setState(() {
          enabled = value;
        });
      },
    );
  }
}

预期结果

text
页面初始显示通知开启。
点击开关后切换为关闭状态。
再次点击后恢复开启状态。

选择 Checkbox 还是 Switch

两者都基于 bool 状态,但语义不同。

控件 适合场景 用户理解
Checkbox 选择、确认、多选列表 我选择了这个选项
Switch 功能启用、配置开关 我打开或关闭这个功能

例如“同意隐私政策”通常使用 Checkbox,因为它表示用户做出选择;“开启自动更新”更适合 Switch,因为它表示系统行为是否启用。

处理状态同步问题

在真实应用中,Switch 或 Checkbox 的状态通常来自更上层的数据,例如配置文件、接口返回或状态管理框架。无论数据来源在哪里,控件都应该保持一个原则:不要自己保存一份独立状态。

当状态来自外部管理时,onChanged 只负责发送变化事件,由状态管理层更新数据,再重新构建界面。这样可以避免多个页面之间出现显示不一致的问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Checkbox 和 Switch 处理选择

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

登录哪都通