Flutter Checkbox 复选框

最新推荐文章于 2025-09-12 12:37:14 发布

原创最新推荐文章于 2025-09-12 12:37:14 发布 · 1.9w 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#Flutter Checkbox #Flutter CheckboxListTile #Flutter 复选框

Flutter 基础专栏收录该内容

73 篇文章

订阅专栏

本文详细介绍了Flutter中两种复选框组件：Checkbox和CheckboxListTile的使用方法及参数设置，包括监听状态变化、自定义样式等，附带代码示例。

Flutter 复选框有两种：一是精简版Checkbox复选框，二是自带标题和副标题CheckboxListTile复选框

参数详解

属性	说明
Checkbox 复选框
value	是否选中此复选框
onChanged	监听当复选框的值应该更改时调用
tristate	默认false，如果为true，复选框的值可以为true、false或null。
activeColor	选中此复选框时要使用的颜色
checkColor	选中此复选框时用于复选图标的颜色
materialTapTargetSize	配置tap目标的最小大小
CheckboxListTile 复选框
value	是否选中此复选框
onChanged	监听当复选框的值应该更改时调用
activeColor	选中此复选框时要使用的颜色
title	列表主标题
subtitle	列表副标题
isThreeLine	默认false
dense	此列表平铺是否是垂直密集列表的一部分。
secondary	显示在复选框前面的小部件
selected	选中后文字高亮，默认false
controlAffinity	控件相对于文本的位置，默认 ListTileControlAffinity.platform

代码示例

Checkbox 复选框

Checkbox(
  value: this.valueb, 
  onChanged: (bool value) {
    setState(() {
      this.valueb = value; 
    });
  },
),

CheckboxListTile 复选框

CheckboxListTile(
  secondary: const Icon(Icons.alarm_on),
  title: const Text('每天6：10 响铃'),
  subtitle: Text('12小时58分钟后响铃'),
  value: this.valued, 
  onChanged: (bool value) {
    setState(() {
      this.valued = value; 
    });
  },
),