شارك المقالة
no image

Toast قابل لإعادة الاستخدام في Flutter باستخدام FToast

أنشئ مكون Toast قابلًا لإعادة الاستخدام في Flutter باستخدام fluttertoast وFToast، مع دعم العربية وتنظيف الرسائل ومراعاة اختلافات المنصات.

لإنشاء Toast قابل لإعادة الاستخدام في Flutter، اجمع تنسيق الرسائل في كلاس واحد يستقبل النص والحالة، واستخدم FToast لعرض Widget مخصص داخل Overlay. يشرح هذا المثال fluttertoast مع دعم العربية ومنع الطابور المتكرر وتنظيف التنبيهات عند التخلص من الصفحة.

الفرق بين Fluttertoast.showToast وFToast

يوفر Fluttertoast.showToast رسالة دون تمرير BuildContext، لكن التحكم في شكلها يختلف حسب المنصة. توضح الحزمة أن خصائص تخصيص معينة قد تتجاهلها إصدارات Android الحديثة. لذلك لا تتوقع تطابق لون الخلفية أو الموقع في جميع الأجهزة بمجرد ضبط الخصائص.

أما FToast فيعرض Widget من Flutter ويحتاج إلى سياق مناسب. هذا يمنحك تحكمًا أوضح في الحواف والنص والأيقونة، لكنه يفرض الاهتمام بالـ Overlay ودورة حياة الصفحة. المثال الحالي يستخدم FToast لهذا السبب، ولا يعتمد على نجاح قناة النظام الأصلية لعرض رسالة مخصصة.

التثبيت وإضافة FToastBuilder

flutter pub add fluttertoast:10.0.2

الإصدار المراجع 10.0.2 يتطلب Dart 3.12 أو أحدث وFlutter 3.44 أو أحدث بحسب بيانات الحزمة. افحص إصدار مشروعك قبل التثبيت. إذا كنت على بيئة أقدم، اختر إصدارًا متوافقًا بعد قراءة توثيقه؛ لا تنسخ المثال مع قيد قديم ثم تتوقع نفس الواجهة البرمجية تلقائيًا.

أضف FToastBuilder إلى MaterialApp كما في نقطة التشغيل التالية. إذا كان لتطبيقك builder موجود بالفعل، ادمج البناءين مع الحفاظ على child الخاص بالملاحة، ولا تحذفه أو تستبدله بشاشة ثابتة، لأن ذلك قد يعطل Navigator. ثم احفظ كود AppToast والصفحة في الملف المستورد.

// main.dart
import 'package:flutter/material.dart';
import 'package:fluttertoast/fluttertoast.dart';
import 'notice_28289.dart';

void main() => runApp(MaterialApp(
  builder: FToastBuilder(),
  home: const ReusableToastPage(),
));

كلاس Toast مشترك وصفحة تستخدمه

import 'package:flutter/material.dart';
import 'package:fluttertoast/fluttertoast.dart';

enum ToastKind { success, error, info }

class AppToast {
  AppToast(this._toast);
  final FToast _toast;

  void show(BuildContext context, String message, ToastKind kind) {
    final (color, icon) = switch (kind) {
      ToastKind.success => (const Color(0xFF146C43), Icons.check_circle_outline),
      ToastKind.error => (const Color(0xFFB3261E), Icons.error_outline),
      ToastKind.info => (const Color(0xFF174EA6), Icons.info_outline),
    };
    _toast.init(context);
    _toast.removeQueuedCustomToasts();
    _toast.removeCustomToast();
    _toast.showToast(
      gravity: ToastGravity.BOTTOM,
      toastDuration: const Duration(seconds: 4),
      child: Semantics(
        liveRegion: true,
        child: Material(
          color: color,
          borderRadius: BorderRadius.circular(16),
          child: Padding(
            padding: const EdgeInsets.all(16),
            child: Directionality(
              textDirection: TextDirection.rtl,
              child: Row(
                mainAxisSize: MainAxisSize.min,
                children: [
                  Icon(icon, color: Colors.white),
                  const SizedBox(width: 8),
                  Flexible(
                    child: Text(message, style: const TextStyle(color: Colors.white)),
                  ),
                ],
              ),
            ),
          ),
        ),
      ),
    );
  }

  void clear() {
    _toast.removeQueuedCustomToasts();
    _toast.removeCustomToast();
  }
}

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

  @override
  State<ReusableToastPage> createState() => _ReusableToastPageState();
}

class _ReusableToastPageState extends State<ReusableToastPage> {
  final _notices = AppToast(FToast());

  @override
  void dispose() {
    _notices.clear();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) => Scaffold(
    body: Center(
      child: FilledButton(
        onPressed: () => _notices.show(context, 'تم نسخ الرابط', ToastKind.success),
        child: const Text('عرض Toast'),
      ),
    ),
  );
}

سياسة الاستبدال والتنظيف

يمسح الكلاس الطابور والتنبيه الحالي قبل عرض الرسالة الجديدة. هذه سياسة مناسبة لتأكيدات قصيرة قد تتكرر بسرعة مثل نسخ الرابط. إذا كنت تعرض نتائج مستقلة يجب ألا تضيع، فلا تمسحها بهذه الطريقة؛ استخدم سجلًا أو واجهة حالة تسمح بمراجعة كل حدث.

تستدعي الصفحة clear في dispose لإزالة التنبيه عند انتهاء عمرها. سياق الصفحة لا يحفظ في متغير عام، ويعاد init عند العرض. وعند استدعاء الرسالة بعد await تحقق من context.mounted أولًا. لا ترسل BuildContext من طبقة البيانات إلى خدمة تبقى أطول من الصفحة.

تحسين النص وإمكانية الوصول

يستخدم المحتوى Semantics مع liveRegion لبيان أن الرسالة تحديث حي، لكن ذلك لا يغني عن تجربة قارئ الشاشة على الجهاز المستهدف. يجب أن يكون النص مفهومًا وحده، وأن يوضح النجاح أو الخطأ دون الاعتماد على الأخضر والأحمر. الأيقونة عنصر مساعد وليست الرسالة الأساسية.

تساعد Flexible على التفاف الرسالة بدل تمدد الصف خارج الشاشة. ومع ذلك، اختبر حجم الخط الكبير واتجاه RTL ولوحة المفاتيح وأزرار أسفل التطبيق. إذا كانت الرسالة طويلة جدًا، انقل الشرح إلى الصفحة واكتف بتلخيص النتيجة. لا تعرض رموز وصول أو استثناءات خادم خامًا داخل Toast.

أسئلة شائعة عن مكون Toast

هل يمكن استدعاء AppToast من كل مكان؟ الأفضل أن تطلب طبقات التطبيق عرض حالة مفهومة، وتتولى الواجهة تنفيذ العرض من سياق صالح. تحويل الكلاس إلى متغير عام لا يحل مشكلة السياق، وقد يجعل رسالة من شاشة قديمة تظهر فوق شاشة جديدة.

هل هذه الرسائل بديل لأخطاء النموذج؟ لا؛ خطأ كلمة المرور أو البريد يجب أن يظهر بجوار الحقل أيضًا. وهل تكفي الاختبارات المحلية؟ فحص الظهور والاستبدال والتنظيف مهم، ثم تحتاج اختبارًا فعليًا على المنصات التي تنشر لها، خاصة إذا اخترت Fluttertoast.showToast الأصلي بدل مسار FToast المعتمد على Widget.

إذا كان التركيز على تأثير الدخول والخروج مع مراعاة تقليل الحركة، راجع Toast متحرك في Flutter باستخدام flutter_styled_toast وحدد سياسة موحدة للتنبيهات في مشروعك.

مراجع التنفيذ

صور توضيحية من الشرح السابق

توضح الصور النسخة السابقة من المثال وقد تحتوي أرقام إصدارات أو استدعاءات قديمة. اعتمد الكود النصي المحدث أعلاه عند التطبيق.

صورة من الشرح السابق: Toast قابل لإعادة الاستخدام في Flutter باستخدام FToast — 1
صورة من الشرح السابق: Toast قابل لإعادة الاستخدام في Flutter باستخدام FToast — 2
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع