إنشاء ThemeExtension في Flutter بقيم تصميم مخصصة وcopyWith وlerp، وتسجيله في الثيمين وقراءته بأمان دون خلطه بامتداد BuildContext أو حزمة خارجية.
متى تحتاج امتدادًا؟
ColorScheme يملك أدوار Material المعروفة، لكن تصميمك قد يحتاج زوج ألوان لحالة نجاح أو بطاقة تعليمية خاصة لا تمثل primary وsecondary. ThemeExtension يضيف عقدًا مسمى داخل ThemeData لهذه القيم. لا تستخدمه لتخزين نتيجة API أو حالة تسجيل دخول؛ تلك بيانات تشغيل لا مجرد تصميم. ابدأ بدور واضح مثل لون خلفية notice ولون النص فوقها، وحدد القيم للفـاتح والداكن بدل نشر لون ثابت في كل بطاقة ثم تصحيحها منفردة.
صنف تصميم بعقد معلوم
الصنف NoticeColors في المثال يرث ThemeExtension
سجله في النطاق الصحيح
أضف مثيل الامتداد داخل extensions في كل ThemeData يحتاجه المحتوى. إذا سجلته في light فقط ثم انتقلت إلى dark فقد ترجع قراءة extension قيمة null. المثال يهيئ الثيمين ويقدم fallback واضحًا في قراءة البطاقة بدل فرض ! على lookup غير مضمون. في مشروع يفرض الامتداد كجزء من عقد التصميم يمكنك اعتماد تحقق تشخيصي أو اختبار تسجيله، لكن يجب توضيح هذا الشرط للمكوّن المعاد استخدامه بدل جعله يتعطل خارج MaterialApp المحدد دون تفسير.
BuildContext extension اختصار Dart
كتابة extension على BuildContext تضيف دالة مساعدة للوصول إلى الثيم، وليست plugin يحتاج تثبيتًا أو آلية تسجيل أخرى في Flutter. هي اختصار لقراءة Theme.of(context).extension
المزج والتباين
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 المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.






