دعم العربية RTL في Flutter: ما تعلّمته من تطبيق Escore ثنائي اللغة
- نُشر
- القراءة
- قراءة في 8 دقائق
- الكاتب
- محمد مجدي إبراهيمقائد تقني لتطبيقات Flutter

دعم العربية RTL في Flutter يقوم على ثلاثة قرارات تُتخذ من أول يوم: أن تأتي كل النصوص من ملفات ARB عبر flutter_localizations، وأن يُكتب كل تخطيط بالبداية والنهاية لا باليسار واليمين، وأن تُعزل الأسماء اللاتينية والأرقام حين تقع داخل جملة عربية. هذه خلاصة ما طبّقته في Escore، تطبيق الرياضات الإلكترونية الذي قُدتُ تطويره بـ Flutter، حيث يبدّل المستخدم بين العربية والإنجليزية أثناء التشغيل فتنقلب الواجهة كلها دون إعادة فتح التطبيق.
أفصل في هذا المقال بين أمرين. ما أقول إننا فعلناه موثّق في مشروع منشور. وما أقول إنني أفحصه هو قائمة عمل أطبّقها على أي تطبيق عربي، مع مقتطفات كود قصيرة تستطيع تجربتها.
ما الذي بنيته في Escore بالعربية والإنجليزية
Escore منصة لمتابعة الرياضات الإلكترونية مباشرة، عملتُ عليها عامًا كاملًا من أغسطس 2025 إلى أغسطس 2026 لصالح Rov Group، وهي شركة سعودية ناشئة. توليت تطبيق Flutter من تصميم البنية حتى النشر على المتجرين، وبنى زميلي محمود حمدي الخادم الخلفي ولوحة التحكم. التفاصيل الكاملة في دراسة حالة Escore.
كان المطلوب واجهة تعمل بالعربية من اليمين لليسار بالكفاءة نفسها التي تعمل بها بالإنجليزية. فبنيت تبديل اللغة أثناء التشغيل مع قلب كامل للاتجاه، ونظام سمات يغطي الوضعين الفاتح والداكن باللغتين.
يخدم التطبيق أكثر من 5,000 مستخدم مسجّل، 74% منهم على iOS و26% على Android، من قاعدة كود واحدة. معنى ذلك أن أي خطأ في الاتجاه يظهر على الجوالين معًا، وأن إصلاحه يصل إليهما في إصدار واحد.
إعداد دعم العربية RTL في Flutter بملفات ARB
يقلب Flutter الاتجاه بنفسه حين تكون اللغة الحالية عربية. حزمة flutter_localizations تعرف أن العربية تُكتب من اليمين، فيضع التطبيق ودجت Directionality في أعلى الشجرة بقيمة rtl، ويقرأ منها كل Row وText وListTile. لذلك تبدأ الخطوة الأولى في الإعداد، لا في الشاشات.
# pubspec.yaml
dependencies:
flutter_localizations:
sdk: flutter
intl: any
flutter:
generate: true
# l10n.yaml
arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart
nullable-getter: false
الخيار nullable-getter: false يجعل AppLocalizations.of(context) يعيد قيمة غير قابلة للعدم، فلا تكرر علامة التأكيد بعد كل استدعاء. ويجري التوليد تلقائيًا مع flutter pub get أو flutter run، أو يدويًا بالأمر flutter gen-l10n.
أكثر ما يستحق الانتباه في ملف app_ar.arb هو صيغ الجمع. للعربية ست صيغ في قواعد CLDR، هي zero وone وtwo وfew وmany وother، بينما تكفي الإنجليزية صيغتان. صيغة ICU في ملفات ARB تسمح بكتابتها كلها:
{
"matchesCount": "{count, plural, =0{لا توجد مباريات} =1{مباراة واحدة} =2{مباراتان} few{{count} مباريات} many{{count} مباراة} other{{count} مباراة}}"
}
من يكتب النسخة العربية بنقل الإنجليزية حرفيًا يخرج بعبارات مثل "3 مباراة". الصيغ الست تمنع ذلك من البداية.
تبديل اللغة أثناء التشغيل دون إعادة فتح التطبيق
يتبع Flutter لغة الجهاز افتراضيًا. أما التبديل داخل التطبيق فيعني أن تصبح اللغة حالة يملكها التطبيق، وأن يُعاد بناء MaterialApp حين تتغير. أستخدم لذلك Cubit، لأن BLoC وCubit هما ما أبني به إدارة الحالة في تطبيقاتي، كما في تطبيق تركيبات.
class LocaleCubit extends Cubit<Locale> {
LocaleCubit(this._prefs) : super(Locale(_prefs.getString('lang') ?? 'ar'));
final SharedPreferences _prefs;
Future<void> change(String code) async {
await _prefs.setString('lang', code);
emit(Locale(code));
}
}
// app.dart
BlocBuilder<LocaleCubit, Locale>(
builder: (context, locale) => MaterialApp(
locale: locale,
supportedLocales: AppLocalizations.supportedLocales,
localizationsDelegates: AppLocalizations.localizationsDelegates,
home: const HomeScreen(),
),
);
لماذا لا نكتفي بلغة الجهاز؟ لأن لغة الهاتف ولغة القراءة تختلفان عند كثير من المستخدمين في المنطقة: جوال مضبوط على الإنجليزية وصاحبه يفضّل قراءة الأخبار بالعربية، أو العكس.
ويُحفظ الاختيار محليًا ليبقى بعد إغلاق التطبيق. SharedPreferences مكان مناسب لقيمة صغيرة كهذه، وهو من أداتي التخزين المحلي اللتين استخدمهما Escore أصلًا مع Hive. وبما أن اللغة والسمة كلتيهما حالة على مستوى التطبيق، أفضّل أن يقرأهما MaterialApp من المكان نفسه، وأن يُحفظا بالطريقة نفسها، فيفتح التطبيق دائمًا كما تركه المستخدم.
start وend بدل left وright في كل تخطيط
يعكس Row ترتيب أبنائه تلقائيًا في العربية، وكذلك AppBar وListTile. ما لا ينقلب هو كل قيمة كُتبت باتجاه ثابت: EdgeInsets.only(left: 16)، وAlignment.centerLeft، وPositioned(left: 0)، وTextAlign.left. لكل منها نظير اتجاهي يقرأ Directionality:
Padding(
padding: const EdgeInsetsDirectional.only(start: 16, end: 8),
child: Align(
alignment: AlignmentDirectional.centerStart,
child: Text(t.liveNow, textAlign: TextAlign.start),
),
);
// inside a Stack
PositionedDirectional(top: 8, end: 8, child: badge);
في أي كود Flutter أستلمه أبدأ ببحث نصي عن left: وright: وcenterLeft وcenterRight وTextAlign.left. كل نتيجة إما خطأ اتجاه ينتظر أن يظهر عند أول مستخدم عربي، أو حالة مقصودة تستحق تعليقًا يشرح سببها.
الأيقونات التي تنقلب والتي تبقى كما هي
القاعدة بسيطة: ما يدل على اتجاه الحركة أو الترتيب ينقلب، وما يمثّل شيئًا من الواقع يبقى. أسهم الرجوع والتقدّم وسهم "التالي" في القوائم تنقلب. أما الساعة وعلامة الصح وزر التشغيل في مشغّل الفيديو وشعارات الفرق فلا تُقلب.
الأيقونة Icons.arrow_back معرّفة في Flutter بخاصية matchTextDirection، فتنقلب وحدها في العربية. الأيقونات المخصصة من ملفات SVG أو PNG لا تعرف شيئًا عن الاتجاه، فأقلبها صراحة:
final isRtl = Directionality.of(context) == TextDirection.rtl;
Transform.flip(
flipX: isRtl,
child: Image.asset('assets/icons/next.png', width: 20),
);
تستطيع رؤية النتيجة في لقطات Escore المنشورة على المتجر. سهم شاشة البطولات يقع أعلى اليمين ويشير إلى اليمين، وهو اتجاه الرجوع الصحيح في واجهة عربية، بينما بقيت شعارات البطولات والفرق كما صممها أصحابها.
الأسماء اللاتينية والأرقام داخل النص العربي
هذا أصعب ما في Escore لغويًا. كل شاشة تقريبًا تعرض أسماء فرق وبطولات لاتينية، مثل Fnatic وTeam Heretics وVALORANT Masters London 2026، داخل واجهة عربية، ومعها نتائج رقمية ووسم "مباشر". يظهر ذلك بوضوح في لقطة شاشة المباريات على المتجر.
محرك النص في Flutter يطبّق خوارزمية Unicode الثنائية الاتجاه، وهي تعامل الأرقام والمسافات والشرطة معاملة خاصة. إذا كتبت النتيجة نصًا واحدًا مثل "2 - 1" داخل فقرة اتجاهها rtl، أخذت الشرطة والمسافات اتجاه الفقرة، فظهر الرقمان بترتيب معكوس بصريًا: "1 - 2". يكون ذلك صحيحًا إذا كان صاحب الرقم الأول على اليمين، وخطأً إذا كان تخطيطك يضعه على اليسار.
الحل الأوضح عندي أن تكون كل قيمة في Text مستقل داخل Row، فيتبع الترتيب اتجاه الصف نفسه. وحين لا بد من جملة واحدة، أعزل الجزء اللاتيني أو الرقمي بمحارف العزل في Unicode:
// U+2068 FSI ... U+2069 PDI: isolate a name of unknown direction
// U+2066 LRI ... U+2069 PDI: force left-to-right for the score
final line = 'فاز $team بنتيجة $home - $away';
والأرقام نفسها قرار يجب أن يُتخذ صراحة: هندية مشرقية (٠١٢) أم غربية (012). مصدرها في الغالب DateFormat وNumberFormat من حزمة intl، وهما يأخذان شكل الأرقام من بيانات اللغة المحددة، وقد يختلف الناتج بين ar وar_SA وar_EG. لذلك أحدد الشكل المطلوب وأفحصه على اللغة الدقيقة التي يستخدمها التطبيق.
وفي Sound to Read، تطبيق يعلّم الأطفال من 6 إلى 12 سنة قراءة الإنجليزية، الوضع معكوس: الواجهة عربية والمحتوى إنجليزي. تُظهر لقطاته على المتجر شبكة الحروف تبدأ بالحرف A في أعلى اليمين تبعًا لاتجاه الواجهة، وقائمة الكلمات في اختبار النطق تُقرأ من اليسار. هنا يحتاج كل جزء إنجليزي إلى textDirection: TextDirection.ltr صريح، ويحتاج ترتيب الحروف إلى قرار مع العميل: هل يتبع اتجاه الواجهة أم اتجاه المحتوى؟
الخط العربي وارتفاع السطر
أحدد الخط من اللغة داخل ThemeData، لأن الخط اللاتيني الجميل نادرًا ما يحمل حروفًا عربية جيدة، والعكس كذلك. ولتطبيق جمهوره على شبكات موبايل بطيئة مثل Escore، أفضّل أن يكون الخط ملفًا داخل التطبيق في pubspec.yaml على أن يُحمَّل من الشبكة عند أول تشغيل.
ثلاث ملاحظات أفحصها في كل نمط نص عربي. الأولى أن letterSpacing يجب أن يبقى صفرًا، لأن التباعد بين الحروف يقطع اتصالها في الكتابة العربية. الثانية أن الحروف العربية تحتاج قيمة height أكبر قليلًا حتى لا تُقص النقاط والحركات. والثالثة أن الترجمة العربية قد تطول عن الإنجليزية، فأجرّب الأزرار بأطول نص فيها.
كيف أختبر كل شاشة باللغتين
في Escore حافظت على اختبارات unit وwidget وintegration للميزات الأساسية، واختبار اللغتين جزء طبيعي من ذلك. أبسط اختبار مفيد أن تُفتح الشاشة نفسها مرة بالعربية ومرة بالإنجليزية في اختبار widget، وأن يفشل الاختبار عند أي overflow.
وقبل التسليم أمرّ على هذه النقاط في كل شاشة:
- فتحها بـ Locale('ar') وLocale('en') والتأكد من عدم ظهور شريط overflow الأصفر
- التبديل بين اللغتين أثناء التشغيل والرجوع إلى الشاشة نفسها
- قراءة كل سطر يجمع أسماء لاتينية وأرقامًا بعين قارئ عربي
- إدخال نص عربي وإنجليزي في كل حقل كتابة
- تجربة التبديل على جهاز أندرويد متواضع
النقطة الأخيرة مهمة لأن تغيير اللغة يعيد بناء الشجرة كلها. على هذا النوع من الأجهزة قِست أداء Escore بـ Flutter DevTools، وما يمر بسلاسة على هاتف المطوّر قد يتقطع على هاتف المستخدم.
إذا كنت تبني تطبيقًا عربيًا أولًا وتريد فريقًا جرّب هذا في الإنتاج، فهذه تفاصيل خدمة تطوير تطبيقات الجوال بـ Flutter.
أرسل لنا وصفًا قصيرًا لتطبيقك من نموذج المشروع.
مشاركة
مقالات في الموضوع نفسه
| رقم | التاريخ | المقال | المواضيع | القراءة |
|---|---|---|---|---|
| 08 | تكلفة تطوير تطبيق جوال في السعودية ومصر، وما الذي يحددها فعلًا | قراءة في 10 دقائق | ||
| 07 | باك إند تطبيق نتائج مباشرة بـ WebSocket: كيف بنينا Escore | قراءة في 8 دقائق | ||
| 01 | لوحة تحكم وتطبيق جوال على API واحد: لماذا بنيناها هكذا في Escore | قراءة في 8 دقائق |