مدیریت وضعیت سراسری با ChangeNotifier و ListenableBuilder

Simple app state management

آموزش عملی پیاده‌سازی مدیریت وضعیت سراسری (App State) در Flutter با استفاده از ChangeNotifier، notifyListeners و ListenableBuilder

فهرست مطالب این صفحه

هنگامی که داده‌های برنامه (مانند سبد خرید، وضعیت احراز هویت یا تنظیمات کاربر) باید در چندین ویجت و صفحه مختلف در دسترس باشند و با تغییر آن‌ها رابط کاربری به‌طور خودکار به‌روز شود، از الگوی مدیریت وضعیت سراسری (App State Management) استفاده می‌کنیم.

الگوی ChangeNotifier در Flutter

کلاس ChangeNotifier در SDK فلاتر گنجانده شده است و مکانیزم اطلاع‌رسانی تغییرات را به شنوندگان (Listeners) فراهم می‌کند:

  1. مدل وضعیت (CartModel): کلاسی که از ChangeNotifier ارث‌بری می‌کند و داده‌های برنامه و متدهای تغییر آن‌ها را نگه می‌دارد.
  2. اعلام تغییر (notifyListeners()): هر زمان داده‌ای در مدل تغییر کرد، متد notifyListeners() فراخوانی می‌شود تا ویجت‌های شنونده بازسازی شوند.
  3. گوش دادن به تغییرات (ListenableBuilder): ویجتی داخلی در فلاتر که به یک ChangeNotifier گوش می‌دهد و فقط زیرشاخه خودش را هنگام تغییر بازسازی می‌کند.
Dart
import 'dart:collection';
import 'package:flutter/material.dart';

class CartModel extends ChangeNotifier {
  final List<String> _items = [];

  UnmodifiableListView<String> get items => UnmodifiableListView(_items);

  int get totalCount => _items.length;

  void addItem(String itemName) {
    _items.add(itemName);
    notifyListeners();
  }

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

اتصال مدل وضعیت به رابط کاربری

با استفاده از ListenableBuilder، تنها بخشی از صفحه که به تغییرات CartModel وابسته است بازسازی می‌شود و بقیه درخت ویجت دست‌نخورده باقی می‌ماند:

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

  @override
  State<ShopScreen> createState() => _ShopScreenState();
}

class _ShopScreenState extends State<ShopScreen> {
  final CartModel _cart = CartModel();

  @override
  void dispose() {
    _cart.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('فروشگاه نمونه'),
        actions: [
          Padding(
            padding: const EdgeInsets.symmetric(horizontal: 16),
            child: Center(
              child: ListenableBuilder(
                listenable: _cart,
                builder: (context, _) {
                  return Text('سبد خرید: ${_cart.totalCount}');
                },
              ),
            ),
          ),
        ],
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () => _cart.addItem('دوره جامع Flutter'),
          child: const Text('افزودن محصول به سبد'),
        ),
      ),
    );
  }
}

توسعه در پروژه‌های بزرگ: برای در دسترس قرار دادن یک ChangeNotifier در کل درخت اپلیکیشن بدون پاس دادن دستی آن از طریق سازنده‌ها، می‌توانید از پکیج‌های محبوبی مانند provider یا riverpod در کنار این الگو استفاده کنید.