إنشاء Dialog في Flutter يستقبل اسمًا ويعيد نتيجة مكتوبة النوع، مع معالجة الإلغاء والتحقق من الإدخال وإغلاق controller وفحص mounted بعد الانتظار.
حدد نتيجة الحوار قبل تصميمه
الحوار مهمة صغيرة مؤقتة فوق الشاشة مثل إدخال اسم عرض أو تأكيد اختيار، وليس بديلًا تلقائيًا لصفحة طويلة. حدد ما الذي يعنيه حفظ وما الذي يعنيه إلغاء، وأبقِ بيانات الشاشة السابقة كما هي عند الإلغاء. في المثال النتيجة String?؛ النص المحفوظ يعود إلى الصفحة، بينما null يعبر عن إغلاق دون حفظ. لا تعرض رسالة نجاح خدمة أو تعديل حساب فعلي لأن المثال يغير قيمة محلية فقط.
اختر سياق الإغلاق
builder الخاص بالحوار يوفر سياقًا تابعًا لمساره. استعمله عند Navigator.pop لإغلاق الحوار نفسه، خصوصًا إذا كان التطبيق يملك متصفحات داخلية متعددة. لا تفترض أن سياق الصفحة الأصلية دائمًا يصل إلى المتصفح الذي فتح الحوار. showDialog يستعمل المتصفح الأعلى افتراضيًا، ولذلك راجع useRootNavigator عند بناء shell. تغيير هذا الخيار دون مراجعة مكان العرض والإغلاق قد يجعل زر حفظ يغلق صفحة تحت الحوار بدل إغلاق الحوار المطلوب.
مالك الموارد داخل الحوار
المثال يفصل NameDialog إلى StatefulWidget يمتلك TextEditingController وينهيه داخل dispose. بذلك لا يعتمد عمر الحقل على بقاء الصفحة الأصلية، ولا يغلق controller مبكرًا أثناء حركة خروج الحوار. إذا مررت controller من خارج المكوّن فحدد مالكه ولا تغلقه مرتين. لا تنشئه داخل build، ولا تشارك مثيلًا واحدًا بين حوارين مفتوحين في الوقت نفسه. initialName هنا قيمة بداية لكل فتح جديد وليس رابطًا دائمًا يغيّر نص المستخدم أثناء الكتابة.
التحقق والانتظار
Form يتحقق من اسم غير فارغ بعد trim ويعيد النص عند القبول. هذا قرار مناسب لاسم عرض تجريبي، وليس قاعدة لتطبيع كل أنواع البيانات مثل كلمات المرور. الصفحة تنتظر نتيجة showDialog ثم تفحص mounted قبل setState؛ قد تكون اختفت أثناء الانتظار. يمنع متغير opening تكرار فتح عدة نسخ بالضغط السريع، ويعاد في finally عند بقاء الصفحة. لا تضع طلب شبكة داخل validator؛ أي حفظ حقيقي يحتاج حالة تحميل وفشل وعقد خدمة مستقلًا.
المساحة والإلغاء
scrollable في AlertDialog يسمح لمحتوى قصير أن يظل قابلًا للوصول في نافذة منخفضة أو مع تكبير الخط. قد يحتاج المحتوى الكبير قيود عرض أو صفحة كاملة، فلا تفرض ارتفاعًا ثابتًا من هاتف واحد. زر Cancel يعيد null، وكذلك الإغلاق من الحاجز في الإعداد الافتراضي. تعطيل barrierDismissible يغير النقر خارج الحوار فقط، ولا يكفي وحده لتعريف سياسة رجوع النظام. وفر مسارًا واضحًا للخروج ولا تحبس المستخدم لحل مشكلة تنسيق.
فحص التدفق
افتح الحوار، جرّب اسمًا فارغًا ثم اسمًا عربيًا طويلًا، واحفظه وتأكد من تحديث الصفحة. افتحه مرة ثانية وغير النص ثم ألغِ؛ يجب أن تبقى القيمة القديمة. اختبر الرجوع ولوحة المفاتيح وحجم الخط الكبير وفتح الحوار مرتين بعد إغلاقه. لا تطبع محتوى الحقول في سجل التطبيق للتشخيص بلا حاجة، ولا ترسل أسماء المستخدمين إلى analytics ضمن حدث إغلاق الحوار. نجاح المثال يثبت تدفقًا محليًا محددًا، ويظل دعم المنصات وإمكانية الوصول بحاجة مراجعة في تطبيقك.
مثال مستقل للتجربة
شغّل المثال داخل مشروع 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> {
String _name = 'Guest';
bool _opening = false;
Future<void> _open() async {
if (_opening) return;
setState(() { _opening = true; });
try {
final result = await showDialog<String>(context: context, builder: (_) => NameDialog(initialName: _name));
if (!mounted || result == null) return;
setState(() { _name = result; });
} finally {
if (mounted) setState(() { _opening = false; });
}
}
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('Dialog result')),
body: ListView(padding: const EdgeInsets.all(16), children: [
Text('Name: $_name'),
ElevatedButton(onPressed: _opening ? null : _open, child: const Text('Edit name')),
]),
);
}
class NameDialog extends StatefulWidget {
const NameDialog({super.key, required this.initialName});
final String initialName;
@override
State<NameDialog> createState() => _NameDialogState();
}
class _NameDialogState extends State<NameDialog> {
final _key = GlobalKey<FormState>();
late final TextEditingController _name;
@override
void initState() { super.initState(); _name = TextEditingController(text: widget.initialName); }
@override
void dispose() { _name.dispose(); super.dispose(); }
void _save() {
if (_key.currentState?.validate() ?? false) Navigator.of(context).pop<String>(_name.text.trim());
}
@override
Widget build(BuildContext context) => AlertDialog(
scrollable: true,
title: const Text('Display name'),
content: Form(key: _key, child: TextFormField(
controller: _name, textInputAction: TextInputAction.done,
decoration: const InputDecoration(labelText: 'Name'),
validator: (value) => (value ?? '').trim().isEmpty ? 'Enter a name' : null,
onFieldSubmitted: (_) => _save(),
)),
actions: [
TextButton(onPressed: () => Navigator.of(context).pop(), child: const Text('Cancel')),
TextButton(onPressed: _save, child: const Text('Save')),
],
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






