فهم StatefulWidget في Flutter وعمر State واستخدام setState بمثال عداد ذي حدود واضحة، مع تصحيح الفرق بين StatelessWidget والتفاعل وإدارة الموارد.
التفاعل ليس الفرق الوحيد
StatelessWidget يستطيع عرض زر وتنفيذ callback والتأثر بقيم تأتي من الأب؛ وصفه بأنه لا يحتوي أي action غير صحيح. الفرق أن حالته المرئية لا يملكها كائن State محلي من هذا النوع. StatefulWidget ينشئ State يمكنه الاحتفاظ بقيم عبر إعادة البناء ما دامت الهوية والعمر مناسبين. اختر مالك الحالة حسب من يحتاجها، وليس حسب وجود onPressed فقط. المثال يحتفظ بعداد داخل صفحة ويجعل الأزرار تعرض حالته وتغيرها.
Widget وState وعمرهما
كائن widget يصف الإعدادات ويفضل أن تكون حقوله غير قابلة للتعديل، بينما State يملك قيمة العداد المحلية. إعادة بناء الأب لا تعني دائمًا إنشاء State جديدة، لكن تغيير الهوية أو إزالة الصفحة قد ينهيها. const constructor لا يجعل قيمة العداد ثابتة ولا يمنع setState في كائن State المرتبط. إذا احتجت مشاركة القيمة بين شاشتين أو استعادتها بعد إغلاق التطبيق فضعها في مالك أو مخزن مناسب بدل افتراض أن StatefulWidget يحفظها دائمًا.
setState يعلن تغيرًا يؤثر في العرض
ضع التغيير المطلوب داخل callback متزامن، ثم يحدد الإطار إعادة البناء المناسبة. لا تجعل callback نفسه async ولا تنفذ حسابًا ثقيلًا داخله لمجرد أن النتيجة ستظهر على الشاشة. تغيير متغير دون إعلام الواجهة قد يبقي النص القديم حتى سبب بناء آخر، ما يجعل الخطأ يبدو متقطعًا. في المثال `_change` يحصر القيمة في نطاق تجريبي ويحدثها مرة، ولا يستعمل print كبديل لعرض الحالة أو لإثبات أن الواجهة أعادت البناء.
حدود العداد جزء من العقد
اخترنا صفرًا إلى 99 لتوضيح حالة تعطيل الأزرار وحدود الإدخال، وهذه ليست قاعدة لكل عداد. زر Minus غير متاح عند صفر وPlus غير متاح عند 99، مع حراسة داخل الدالة أيضًا. إذا كان عداد سلة أو مخزونًا فعليًا فحدوده تتبع البيانات والخادم، ولا تكفي حالة الواجهة لحماية الكمية. لا تترك الزر يبدو متاحًا بينما يخفي استثناء أو يصحح قيمة سرًا دون أن يفهم المستخدم سبب عدم التغيير.
التهيئة والموارد
القيمة الابتدائية البسيطة يمكن تعريفها كحقل، ولا تحتاج initState فارغًا لمجرد وجوده في كل مثال. إذا أنشأت controller أو اشتراكًا أو مؤقتًا فستحتاج إدارة عمره وإغلاق ما تملكه في dispose. بعد await افحص mounted قبل التحديث، والأفضل إلغاء العمل عندما تسمح واجهته. لا تستخدم mounted لتبرير تسريب مورد يستمر في الخلفية بعد مغادرة الصفحة. المثال لا يملك موردًا خارجيًا، لذلك يبقى أصغر من نموذج تسجيل أو شاشة شبكة.
الاختبار والوصول
اختبر الزيادة والنقصان وإعادة الضبط والضغط عند الحدود، ثم أعد بناء الأب وتحقق من بقاء القيمة عندما تبقى الهوية نفسها. جرّب تكبير النص والعرض الضيق وقارئ الشاشة؛ Wrap يمنع حشر الأزرار في Row لا يتسع. Semantics مع liveRegion يتيح الإعلان عن تغير العداد، ويجب مراجعة التجربة الفعلية حتى لا يصبح الإعلان مزعجًا مع تحديثات سريعة. نجاح هذا المثال لا يعني أن كل بيانات التطبيق ينبغي تخزينها في صفحة واحدة؛ فصل الحالة المحلية والمشتركة قرار تصميم يتبع الحاجة.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatefulWidget {
const DemoPage({super.key});
@override
State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
int _count = 0;
void _change(int delta) => setState(() { _count = (_count + delta).clamp(0, 99).toInt(); });
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('Local counter state')),
body: ListView(padding: const EdgeInsets.all(16), children: [
Semantics(liveRegion: true, child: Text('Count: $_count', style: Theme.of(context).textTheme.headlineMedium)),
const SizedBox(height: 16),
Wrap(spacing: 8, runSpacing: 8, children: [
ElevatedButton(onPressed: _count == 0 ? null : () => _change(-1), child: const Text('Minus')),
ElevatedButton(onPressed: _count == 99 ? null : () => _change(1), child: const Text('Plus')),
TextButton(onPressed: () => setState(() { _count = 0; }), child: const Text('Reset')),
]),
const SizedBox(height: 16),
const Text('The range 0–99 is a local demonstration rule, not a storage or server guarantee.'),
]),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.






