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

تبديل الوضع الليلي في Flutter وحفظ ThemeMode

الوضع الليلي في Flutter: احفظ اختيار system أو light أو dark كقيمة واضحة، وطبقه في MaterialApp.

الوضع الليلي في Flutter يدار من MaterialApp عبر ThemeMode وليس بتغيير لون مصباح داخل الشاشة فقط. يحتاج المستخدم إلى اختيار واضح بين إعداد النظام والوضع الفاتح والداكن، ثم حفظ الاختيار واستعادته قبل عرض الواجهة. يوضح هذا الدرس طبقة صغيرة مسؤولة عن التفضيل دون خلطها برسوم التحويل.

تمثيل القيمة المخزنة

يحفظ المثال أسماء system وlight وdark. تحول decodeTheme القيمة المفقودة أو القديمة إلى system، فلا يؤدي تغيير صيغة التخزين أو وجود قيمة غير معروفة إلى crash. لا تحفظ مجرد bool إذا كنت تريد دعم خيار اتباع النظام أيضًا.

التحميل وربط MaterialApp

بعد WidgetsFlutterBinding.ensureInitialized استدع ThemeChoice.load، ثم مرر الكائن إلى التطبيق. استخدم ListenableBuilder أو مدير الحالة المعتمد لإعادة بناء MaterialApp مع themeMode: choice.mode، وأضف theme وdarkTheme منفصلين. المقطع ليس main كاملًا؛ هو مكون إعدادات قابل للدمج.

ترتيب الحفظ والإشعار

تنتظر choose نجاح الكتابة قبل تغيير القيمة وإرسال notifyListeners. عالِج الفشل في زر الاختيار وأعد تمكينه، ولا تعرض نجاح حفظ لم يحدث. إذا كانت هناك عدة مصادر للتفضيل فحدد أيها صاحب القرار عند العودة من الخلفية أو تسجيل الدخول.

الرسوم والتباين

يمكن إضافة حركة المصباح بعد صحة منطق التفضيل، لكن لا تعتمد عليها كمصدر للحالة. اختبر الشاشات والحقول والصور وشريط النظام في الوضعين، ثم جرّب اتباع إعداد النظام. الاختبار يتحقق من التحويل والقيم القديمة؛ استعادة التخزين ودورة حياة التطبيق تحتاج تجربة فعلية.

الإعداد

flutter pub add shared_preferences

مثال تطبيقي

المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.

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

ThemeMode decodeTheme(String? value) => switch (value) {
  'light' => ThemeMode.light,
  'dark' => ThemeMode.dark,
  _ => ThemeMode.system,
};
class ThemeChoice extends ChangeNotifier {
  ThemeChoice(this.preferences, this.mode);
  final SharedPreferencesAsync preferences;
  ThemeMode mode;
  static Future<ThemeChoice> load() async {
    final preferences = SharedPreferencesAsync();
    return ThemeChoice(preferences, decodeTheme(await preferences.getString('theme_mode')));
  }
  Future<void> choose(ThemeMode next) async {
    await preferences.setString('theme_mode', next.name);
    mode = next;
    notifyListeners();
  }
}
// Load before runApp, then rebuild MaterialApp with choice.mode when notified.

تطبيق الوضع الليلي في Flutter في مشروعك

احفظ اختيار system أو light أو dark كقيمة واضحة، وطبقه في MaterialApp؛ تغيير لون المصباح وحده لا يبدل ThemeMode ولا يحفظ التفضيل.

مراجع الموضوع: api.flutter.dev — themeMode.html

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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