Flutter 基于ageRestriction值实现单次弹出Age Restriction弹窗
年龄限制弹窗功能失效问题修复
需求目标
- 针对传入的
ageRestriction字符串值,每个独立值仅触发一次年龄确认弹窗 - 已弹窗确认过的年龄值需持久化存储,后续即使相同年龄值再次出现也不再触发弹窗
- 首次出现的未记录年龄值,用户点击按钮时需正常弹出确认框
核心问题定位
- 变量初始化缺失:
storedAges未在组件初始化阶段从本地存储读取赋值,首次触发点击时值为null,直接触发空指针错误 - 读写逻辑不严谨:SharedPreferences本地实例未完成初始化时直接同步读取数据,存在取值为空、写入操作未完成就读取的时序问题
- 空值保护缺失:首次存储年龄值时本地无对应key,
getStringList返回null,直接调用列表add方法会抛出异常 - 语法书写错误:InkWell的onTap方法重复嵌套,无法正常触发点击回调
- 异步方法未同步:弹窗确认回调内的本地写入操作未加await等待完成,紧接着读取的列表始终是旧值
- 列表重复写入风险:原有追加逻辑未做去重,可能导致同一个年龄值在存储列表中重复出现
修复实现
1. 重构SharedPreferences工具类
增加空值保护、异步等待、去重逻辑:
class SharedPreferencesHelper { static SharedPreferences? _prefs; // 需在App启动阶段调用完成初始化 static Future<void> init() async { _prefs = await SharedPreferences.getInstance(); } // 清空已存储的年龄列表(按需调用) Future<bool> resetAgeList() async { return await _prefs?.remove("AgeList") ?? false; } // 追加年龄值到本地列表,自动去重、空值保护 Future<bool> addToAgeList(String age) async { List<String> currentList = _prefs?.getStringList("AgeList") ?? []; if (!currentList.contains(age)) { currentList.add(age); return await _prefs?.setStringList("AgeList", currentList) ?? false; } return true; } // 读取已存储的年龄列表,空值时返回空数组 List<String> getAgeList() { return _prefs?.getStringList("AgeList") ?? []; } }
2. 组件层逻辑修正
- 在
initState阶段提前读取已存储的年龄列表,赋值给成员变量 - 移除重复嵌套的onTap语法错误
- 所有本地存储操作加await,保证读写时序正确
- 移除不必要的setState调用,减少UI冗余重建
修正后的组件核心代码:
// 成员变量定义 String? ageRestriction; List<String> storedAges = []; @override void initState() { super.initState(); // 组件初始化时提前加载已存储的年龄列表 storedAges = SharedPreferencesHelper().getAgeList(); } // 按钮逻辑 InkWell( onTap: () async { if(widget.ageRestriction != null && widget.ageRestriction.isNotEmpty){ final hasShownDialog = storedAges.contains(widget.ageRestriction); // 已弹过对应弹窗,直接执行原有点击逻辑 if (hasShownDialog) { widget.onPressed(); return; } // 未弹过弹窗则展示确认框 AwesomeDialog( popContext: false, context: context, dialogType: DialogType.WARNING, animType: AnimType.TOPSLIDE, btnOkText: S.of(context).yes, body: Column( mainAxisAlignment: MainAxisAlignment.center, crossAxisAlignment: CrossAxisAlignment.center, children: [ Text( S.of(context).are_you_18(widget.ageRestriction), style: TextStyle( fontSize: 16, fontFamily: "Montserrat", fontWeight: FontWeight.bold ), ), ], ), btnOkOnPress: () async { // 等待本地写入完成 await SharedPreferencesHelper().addToAgeList(widget.ageRestriction); // 更新本地缓存的已弹窗列表 storedAges = SharedPreferencesHelper().getAgeList(); widget.onPressed(); }, btnCancelOnPress: () { // 取消操作不写入存储、不触发后续点击逻辑 }, btnCancelText: S.current.no, btnOkColor: Theme.of(context).accentColor, btnCancelColor: Color(0xFF084457).withOpacity(0.9), ).show(); }else { widget.onPressed(); } }, ),
效果验证
- 当
ageRestriction为"18"时,首次点击弹出确认框,用户确认后"18"被存入本地列表 - 后续
ageRestriction为"18"时,直接执行原有点击逻辑,不再弹窗 - 当
ageRestriction切换为"20"时,首次点击弹出对应确认框,确认后"20"被存入列表 - 后续再切回"18"时,因已存在于存储列表中,不再触发弹窗,完全匹配需求
内容的提问来源于stack exchange,提问作者Rock
相关产品推荐
相关产品推荐

