跳到正文
教程首页
FlutterCH 11ch11_state_management

ch11-state-management

状态管理:从 setState 到 InheritedWidget 再到 Riverpod。完整工程共 105 个文件,其中 65 个文本源文件可在下面在线阅读。

65

在线文本文件

4,024

源码行数

dart / c / yaml

语言

284 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

textxmldartjsonkotlin

65 text files · 4,024 lines

dartlib/src/change_notifier_cart.dart
// 层次 3:ChangeNotifier + ListenableBuilder —— Flutter 自带的"可监听模型"。
//
// 特点:模型自己保存状态、自己通知;UI 通过 ListenableBuilder 订阅。
// 缺点(正是 Riverpod 要解决的):
//   - 谁创建谁负责传递,跨页共享要靠 InheritedWidget 或全局单例;
//   - 通知是"整块"的,无法细粒度选择订阅哪一部分;
//   - 测试要手动处理 listener 生命周期。
import 'package:flutter/material.dart';

import 'cart_item.dart';

/// 纯 Dart 的模型层:不依赖 BuildContext,可以脱离 UI 单测。
class CartModel extends ChangeNotifier {
  final List<CartItem> _items = <CartItem>[];

  /// 对外只读,外部想改必须走方法(否则 notifyListeners 会被绕过)。
  List<CartItem> get items => List<CartItem>.unmodifiable(_items);

  int get totalCents => _items.fold(0, (int sum, CartItem i) => sum + i.subtotalCents);

  void add(CartItem item) {
    _items.add(item);
    notifyListeners();
  }

  void removeAt(int index) {
    _items.removeAt(index);
    notifyListeners();
  }

  void clear() {
    _items.clear();
    notifyListeners();
  }
}

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

  @override
  State<ChangeNotifierCartDemo> createState() => _ChangeNotifierCartDemoState();
}

class _ChangeNotifierCartDemoState extends State<ChangeNotifierCartDemo> {
  final CartModel _model = CartModel();

  @override
  void dispose() {
    _model.dispose(); // ChangeNotifier 也是"有生命周期的资源"
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        // ListenableBuilder 是 AnimatedBuilder 的语义化版本:监听任意 Listenable。
        // builder 里的内容会随 notifyListeners() 重建,外面的部分不受影响。
        ListenableBuilder(
          listenable: _model,
          builder: (BuildContext context, Widget? child) {
            return Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                Text(
                  '共 ${_model.items.length} 件,合计 ¥${(_model.totalCents / 100).toStringAsFixed(2)}',
                  key: const Key('cn-total'),
                  style: Theme.of(context).textTheme.titleMedium,
                ),
                const SizedBox(height: 4),
                if (_model.items.isEmpty)
                  const Text('(空购物车)', key: Key('cn-empty'))
                else
                  for (var i = 0; i < _model.items.length; i++)
                    Row(
                      key: Key('cn-item-$i'),
                      children: [
                        Expanded(child: Text(_model.items[i].toString())),
                        IconButton(
                          icon: const Icon(Icons.close),
                          onPressed: () => _model.removeAt(i),
                        ),
                      ],
                    ),
              ],
            );
          },
        ),
        const SizedBox(height: 8),
        Wrap(
          spacing: 8,
          children: [
            for (final CartItem item in catalog)
              OutlinedButton(
                key: Key('cn-add-${item.sku}'),
                onPressed: () => _model.add(item),
                child: Text('+ ${item.name}'),
              ),
          ],
        ),
      ],
    );
  }
}

代码构成:text 62 KB · xml 41 KB · dart 29 KB · json 4 KB

本地运行

zip → 解压 → 执行
$cd examples/ch11-state-management && flutter run -d macos

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • flutter analyze 0 告警、flutter test 11 个用例全绿、flutter build macos --debug 真实构建并启动成功
查看全部示例