Flutter中CheckboxListTile跨页返回选中状态丢失的保存方法
问题核心原因
- 原代码中
CheckboxListTile的value参数直接硬编码为false,没有绑定动态状态变量,哪怕页面没有被销毁,每次组件重新build时都会强制渲染为未勾选状态 - 原逻辑触发勾选回调时,既不更新本地状态变量,也不做状态持久化存储,跳转条款页返回后自然无法恢复之前的选择
- 没有适配Flutter空安全规则,新版本SDK下
onChanged回调的参数为可空布尔值,缺少空值判断容易引发运行时崩溃
完整可落地解决方案
1. 引入本地存储依赖
在项目pubspec.yaml的dependencies节点下添加shared_preferences依赖:
dependencies: flutter: sdk: flutter shared_preferences: ^2.2.2 # 保留项目原有其他依赖即可
添加完成后执行flutter pub get拉取依赖包。
2. 核心逻辑改造
关键修改方向
- 在页面State类中新增动态状态变量,承接当前勾选状态
- 重写
initState生命周期,页面初始化时从本地存储读取历史勾选状态 - 修改勾选回调逻辑:先更新本地内存状态、写入本地持久化,再触发页面跳转
- 替换原来硬编码的
value: false为动态绑定的状态变量
修改后的完整可运行代码
import 'package:easy_localization/easy_localization.dart'; import 'package:flutter/cupertino.dart'; import 'package:flutter/material.dart'; import 'package:shared_preferences/shared_preferences.dart'; import 'LawsOfNewUser.dart'; void main() { runApp( EasyLocalization( saveLocale: true, supportedLocales: [Locale('en', 'US'), ], path: 'assets/translations', fallbackLocale: Locale('en', 'US'), child: NewMembership(), ), ); } class NewMembership extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( home: LoginScreen(), ); } } class LoginScreen extends StatefulWidget { @override _LoginScreenState createState() => _LoginScreenState(); } class _LoginScreenState extends State<LoginScreen> { // 页面内存内的勾选状态变量,默认未勾选 bool _isTermsAgreed = false; // 本地存储key常量,避免硬编码拼写错误 static const String _termsCheckKey = "key_terms_agree"; @override void initState() { super.initState(); // 页面初始化时加载本地存储的历史勾选状态 _loadSavedCheckStatus(); } // 从本地存储读取历史勾选状态 Future<void> _loadSavedCheckStatus() async { final prefs = await SharedPreferences.getInstance(); // 无历史存储时默认取未勾选状态 final savedStatus = prefs.getBool(_termsCheckKey) ?? false; // 页面仍在挂载状态下才更新UI,避免异步报错 if(mounted) { setState(() { _isTermsAgreed = savedStatus; }); } } // 将勾选状态持久化到本地存储 Future<void> _saveCheckStatus(bool status) async { final prefs = await SharedPreferences.getInstance(); await prefs.setBool(_termsCheckKey, status); } @override Widget build(BuildContext context) { return Scaffold( body: Center( child: SingleChildScrollView( child: Container( child: Column( children: [ Card( child: Column( children: [ CheckboxListTile( title: Text('Terms'.tr()), // 绑定动态状态变量,替换原硬编码的false value: _isTermsAgreed, onChanged: (bool? newValue) { // 空值判断,适配空安全规则 if(newValue == null) return; setState(() { // 更新内存内的勾选状态 _isTermsAgreed = newValue; }); // 持久化存储勾选状态 _saveCheckStatus(newValue); // 跳转条款详情页 Navigator.push( context, MaterialPageRoute(builder: (context) => LawsUser()), ); } ), ], ), ), ], ), ), ), ), ); } }
3. 实现效果
- 从条款详情页返回原页面时,组件会直接渲染内存中保存的勾选状态,不会出现状态清空的问题
- APP被后台杀掉、重启后,再次进入页面会自动读取本地存储的历史勾选状态,选择不会丢失
内容的提问来源于stack exchange,提问作者user14451514
相关产品推荐
相关产品推荐

