مدیریت وضعیت سراسری با ChangeNotifier و ListenableBuilder
Simple app state managementآموزش عملی پیادهسازی مدیریت وضعیت سراسری (App State) در Flutter با استفاده از ChangeNotifier، notifyListeners و ListenableBuilder
فهرست مطالب این صفحه
هنگامی که دادههای برنامه (مانند سبد خرید، وضعیت احراز هویت یا تنظیمات کاربر) باید در چندین ویجت و صفحه مختلف در دسترس باشند و با تغییر آنها رابط کاربری بهطور خودکار بهروز شود، از الگوی مدیریت وضعیت سراسری (App State Management) استفاده میکنیم.
الگوی ChangeNotifier در Flutter
کلاس ChangeNotifier در SDK فلاتر گنجانده شده است و مکانیزم اطلاعرسانی تغییرات را به شنوندگان (Listeners) فراهم میکند:
- مدل وضعیت (
CartModel): کلاسی که ازChangeNotifierارثبری میکند و دادههای برنامه و متدهای تغییر آنها را نگه میدارد. - اعلام تغییر (
notifyListeners()): هر زمان دادهای در مدل تغییر کرد، متدnotifyListeners()فراخوانی میشود تا ویجتهای شنونده بازسازی شوند. - گوش دادن به تغییرات (
ListenableBuilder): ویجتی داخلی در فلاتر که به یکChangeNotifierگوش میدهد و فقط زیرشاخه خودش را هنگام تغییر بازسازی میکند.
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 وابسته است بازسازی میشود و بقیه درخت ویجت دستنخورده باقی میماند:
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در کنار این الگو استفاده کنید.