You need to enable JavaScript to run this app. Flutter 基于ageRestriction值实现单次弹出Age Restriction弹窗
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 18:15:03