شارك المقالة
ThemeExtension في Flutter لألوان وحالات تصميم مخصصة

ThemeExtension في Flutter لألوان وحالات تصميم مخصصة

إنشاء ThemeExtension في Flutter بقيم تصميم مخصصة وcopyWith وlerp، وتسجيله في الثيمين وقراءته بأمان دون خلطه بامتداد BuildContext أو حزمة…

إنشاء ThemeExtension في Flutter بقيم تصميم مخصصة وcopyWith وlerp، وتسجيله في الثيمين وقراءته بأمان دون خلطه بامتداد BuildContext أو حزمة خارجية.

متى تحتاج امتدادًا؟

ColorScheme يملك أدوار Material المعروفة، لكن تصميمك قد يحتاج زوج ألوان لحالة نجاح أو بطاقة تعليمية خاصة لا تمثل primary وsecondary. ThemeExtension يضيف عقدًا مسمى داخل ThemeData لهذه القيم. لا تستخدمه لتخزين نتيجة API أو حالة تسجيل دخول؛ تلك بيانات تشغيل لا مجرد تصميم. ابدأ بدور واضح مثل لون خلفية notice ولون النص فوقها، وحدد القيم للفـاتح والداكن بدل نشر لون ثابت في كل بطاقة ثم تصحيحها منفردة.

صنف تصميم بعقد معلوم

الصنف NoticeColors في المثال يرث ThemeExtension ويمتلك حقولًا final وconstructor ثابتًا. copyWith يعيد نسخة مع استبدال القيم غير null، وlerp يحدد كيف تنتقل القيم أثناء أنيميشن الثيم. إرجاع this من lerp دائمًا قد يجعل الانتقال يقفز بدل أن يتدرج. لا تكتب توقيعًا عامًا مبهمًا يصعب فهمه إن كان الإصدار يقبل توقيعًا محددًا، ولا تضف عشرات الألوان التي لا تستعملها فعليًا لمجرد أن الامتداد يسمح بذلك.

سجله في النطاق الصحيح

أضف مثيل الامتداد داخل extensions في كل ThemeData يحتاجه المحتوى. إذا سجلته في light فقط ثم انتقلت إلى dark فقد ترجع قراءة extension قيمة null. المثال يهيئ الثيمين ويقدم fallback واضحًا في قراءة البطاقة بدل فرض ! على lookup غير مضمون. في مشروع يفرض الامتداد كجزء من عقد التصميم يمكنك اعتماد تحقق تشخيصي أو اختبار تسجيله، لكن يجب توضيح هذا الشرط للمكوّن المعاد استخدامه بدل جعله يتعطل خارج MaterialApp المحدد دون تفسير.

BuildContext extension اختصار Dart

كتابة extension على BuildContext تضيف دالة مساعدة للوصول إلى الثيم، وليست plugin يحتاج تثبيتًا أو آلية تسجيل أخرى في Flutter. هي اختصار لقراءة Theme.of(context).extension() من السياق المناسب، ويمكن الاستغناء عنها إذا كانت تخفي شرطًا مهمًا. لا تحفظ نتيجة القراءة في متغير عام ثم تتوقع أن تتغير مع أقرب Theme. القراءة داخل build تنشئ الاعتماد على الثيم وتبقي المكوّن منسجمًا مع نطاقه الحالي، بينما نسخة مخزنة قد تصبح قديمة.

المزج والتباين

Color.lerp يخلط قيم الألوان أثناء الانتقال، ولا يثبت أن كل نقطة وسطية تملك تباينًا كافيًا للنص. اختبر زوج الخلفية والمقدمة معًا، ولا تجعل success مجرد أخضر بلا تسمية أو أيقونة. يمكن لامتداد أن يضم قيمًا أخرى مثل radius أو spacing مع سياسة مزج مناسبة، لكن لا تربط أحجام النص المهمة بمعادلة تشوه الوصول. كذلك ColorScheme لا يصبح غير ضروري بعد إضافة امتداد؛ احتفظ بأدوار Material لأغراضها وأضف القيم الخاصة عندما يوضح ذلك التصميم.

المراجعة والاختبار

اختبر copyWith أنه يحافظ على الحقل الذي لم تستبدله، وlerp عند البداية والنهاية ونقطة وسط، وتوفر الامتداد في الثيمين. افتح البطاقة داخل Theme لا يملك الامتداد لتراجع fallback المقصود، ثم بدّل الوضع وتحقق من تغير الألوان مع بقاء التسمية مقروءة. المثال لا يحتاج حزمة خارجية ولا ملف صور. لا يعد تقليل التكرار ضمان سرعة تلقائيًا؛ هنا الفائدة عقد تصميم واحد يمكن تغييره واختباره بدل قيم متفرقة. قياس أداء الأنيميشن على الأجهزة الفعلية يبقى خطوة مستقلة عن نجاح اختبارات القيم.

مثال مستقل للتجربة

شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.

import 'package:flutter/material.dart';
void main() => runApp(const DemoApp());
@immutable
class NoticeColors extends ThemeExtension<NoticeColors> {
  const NoticeColors({required this.background, required this.foreground});
  final Color background;
  final Color foreground;
  @override
  NoticeColors copyWith({Color? background, Color? foreground}) => NoticeColors(
    background: background ?? this.background, foreground: foreground ?? this.foreground);
  @override
  NoticeColors lerp(covariant NoticeColors? other, double t) {
    if (other == null) return this;
    return NoticeColors(background: Color.lerp(background, other.background, t)!, foreground: Color.lerp(foreground, other.foreground, t)!);
  }
}
ThemeData buildNoticeTheme(Brightness brightness) => ThemeData(
  colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF00695C), brightness: brightness),
  extensions: [brightness == Brightness.dark
    ? const NoticeColors(background: Color(0xFF123C30), foreground: Color(0xFFDDFFEF))
    : const NoticeColors(background: Color(0xFFD7F5E9), foreground: Color(0xFF123C30))],
);
class DemoApp extends StatefulWidget {
  const DemoApp({super.key});
  @override
  State<DemoApp> createState() => _DemoAppState();
}
class _DemoAppState extends State<DemoApp> {
  bool _dark = false;
  @override
  Widget build(BuildContext context) => MaterialApp(
    theme: buildNoticeTheme(Brightness.light), darkTheme: buildNoticeTheme(Brightness.dark),
    themeMode: _dark ? ThemeMode.dark : ThemeMode.light,
    home: Scaffold(appBar: AppBar(title: const Text('Custom theme tokens')),
      body: ListView(padding: const EdgeInsets.all(16), children: [
        SwitchListTile(title: const Text('Dark theme'), value: _dark, onChanged: (value) => setState(() { _dark = value; })),
        const NoticeCard(),
      ])),
  );
}
class NoticeCard extends StatelessWidget {
  const NoticeCard({super.key});
  @override
  Widget build(BuildContext context) {
    final theme = Theme.of(context);
    final colors = theme.extension<NoticeColors>() ?? NoticeColors(background: theme.colorScheme.secondaryContainer, foreground: theme.colorScheme.onSecondaryContainer);
    return ColoredBox(key: const ValueKey('notice-colors'), color: colors.background,
      child: Padding(padding: const EdgeInsets.all(16), child: Text('Success: local example ready', style: TextStyle(color: colors.foreground))));
  }
}

مرجع الواجهة البرمجية

راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.

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

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