إنشاء ThemeData في Flutter باستخدام ColorScheme وTextTheme، وتطبيق أنماط المكونات من مكان واحد وفهم أولوية النمط المحلي والسياق الصحيح للثيم.
ابدأ بأدوار التصميم
الثيم العام يحدد لغة مشتركة للألوان والخطوط والأزرار بدل تكرار قيم ثابتة في كل شاشة. حدد أدوارًا مثل سطح البطاقة ولون المحتوى ولون الإجراء الأساسي، ثم استعمل ColorScheme وخصائص المكونات المناسبة. لا تجعل كل قيمة اسمها primary لمجرد أنها تظهر كثيرًا، ولا تستخدم اللون نفسه للنص والخلفية دون فحص التباين. المثال يبني تطبيقًا صغيرًا بصفحة واحدة حتى يمكن رؤية أثر الثيم دون الاعتماد على NewsLayout أو أصناف من مشروع خاص.
مصدر إعداد واحد
ThemeData يوضع في MaterialApp عبر theme، وتستفيد مكونات Material منه تلقائيًا حسب عقودها. يمكن تعريف filledButtonTheme أو inputDecorationTheme لتوحيد أزرار وحقول التطبيق. لا تحتاج حزمة hexcolor لكتابة Color من قيمة HEX؛ وجود مكتبة في مثال قديم لا يجعلها شرطًا للثيم. كذلك لا تنقل كل إعداد متاح إلى الملف لمجرد إكمال قائمة خصائص؛ ابدأ بالقيم التي يحتاجها تصميمك وراجع أثرها عند تحديث Flutter.
السياق الذي يقرأ Theme
Theme.of(context) يبحث عن أقرب Theme أعلى ذلك السياق. إذا حاولت قراءته من السياق نفسه الذي يبني MaterialApp فقد لا تقرأ الثيم الجديد الذي تنشئه تحته. ضع صفحة أو Builder أسفل MaterialApp، ثم اقرأ colorScheme وtextTheme هناك. المثال يفصل DemoPage عن MyApp لهذا السبب. لا تستخدم متغير ThemeData عامًا لكل قراءة إذا كان المحتوى قد يقع داخل Theme محلي؛ ذلك يتجاوز النطاق المقصود ويجعل الجزء المعاد استخدامه لا يحترم مضيفه.
أولوية النمط المحلي
قيمة مباشرة على widget قد تتغلب على ما يأتي من الثيم. إذا لم يتغير لون زر أو نص مع الثيم فراجع style وcolor محليين قبل افتراض فشل ThemeData. يمكن عمل Theme فرعي باستخدام copyWith لتخصيص جزء مقصود، كما يوضح المثال منطقة زر واحدة. هذا لا يغير ثيم التطبيق كله ولا يحفظ إعدادًا للمستخدم. ضع الاستثناء في نطاق ضيق وسمّه بوضوح حتى لا يتحول كل مكوّن إلى ثيم مستقل يكسر الاتساق الذي أردت بناءه.
الخطوط والثيم الحديث
استخدم أسماء TextTheme الحالية مثل titleLarge وbodyMedium بدل نسخ bodyText1 وbodyText2 القديمة دون تحقق. لا تضبط كل النصوص على حجم واحد أو وزن bold واحد لأن التسلسل البصري يحتاج تمييزًا بين العنوان والوصف والإجراء. إذا أضفت خطًا مخصصًا فعرّف ملفه وأوزانه في pubspec وتحقق من ترخيصه، فـ fontFamily لا ينزل الملف تلقائيًا. كذلك إعداد شريط النظام قد يخضع لسلوك المنصة وedge-to-edge ولا ينبغي نسخه كضمان لون ثابت لكل إصدار.
مراجعة الثيم
افحص البطاقة والزر والحقل ورسالة الخطأ وحالات التعطيل والتركيز، لا العنوان وحده. جرّب العربية وتكبير الخط والوضع الأفقي، وراجع التباين على الخلفية الحقيقية. المثال يوضح ثيمًا فاتحًا ونطاقًا محليًا مختلفًا، بينما الثيمان وتحديد ThemeMode وحفظ الاختيار لهما دروس مستقلة مرتبطة أدناه. لا يعني توحيد القيم أن التطبيق أصبح أسرع تلقائيًا؛ فائدته الأساسية هنا وضوح التصميم والصيانة، وأي ادعاء أداء يحتاج قياسًا. لا توجد خدمة شبكة أو أصل خارجي لتشغيل هذا المثال.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MyApp());
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
final scheme = ColorScheme.fromSeed(seedColor: const Color(0xFF00695C));
return MaterialApp(
theme: ThemeData(
useMaterial3: true, colorScheme: scheme,
inputDecorationTheme: const InputDecorationTheme(border: OutlineInputBorder()),
filledButtonTheme: FilledButtonThemeData(style: FilledButton.styleFrom(minimumSize: const Size(0, 48))),
),
home: const DemoPage(),
);
}
}
class DemoPage extends StatelessWidget {
const DemoPage({super.key});
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
final localScheme = ColorScheme.fromSeed(seedColor: const Color(0xFF7B1FA2));
return Scaffold(
appBar: AppBar(title: const Text('Shared theme')),
body: ListView(padding: const EdgeInsets.all(16), children: [
Text('Lesson settings', style: theme.textTheme.titleLarge),
const SizedBox(height: 16),
Card(child: Padding(padding: const EdgeInsets.all(16), child: Text('This card follows the app theme.', style: theme.textTheme.bodyMedium))),
const SizedBox(height: 16),
const TextField(decoration: InputDecoration(labelText: 'Lesson name')),
const SizedBox(height: 16),
FilledButton(key: const ValueKey('global-button'), onPressed: () {}, child: const Text('Global style')),
const SizedBox(height: 16),
Theme(data: theme.copyWith(colorScheme: localScheme), child: Builder(builder: (localContext) => FilledButton(
key: const ValueKey('local-button'), onPressed: () {},
child: Text('Local style', style: Theme.of(localContext).textTheme.labelLarge?.copyWith(color: localScheme.onPrimary)),
))),
]),
);
}
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






