دليل · العربية واتجاه الكتابة

Flutter بالعربية، لمستخدمين في سوريا.

Flutter خيارنا الأول لتطبيقات الموبايل، ودعمه للكتابة من اليمين لليسار جيد. لكن ثلاثة أمور توقع الفرق: أسماء أشهر مصرية بدل السورية، وعلامة جنيه على الأسعار السورية، وتعارض أسماء في حزمة intl. هذا الإعداد الذي اختبرناه.

آخر تحديث: 16 تشرين الثاني 2026تاريخ التحقق من المصادر: 16 تشرين الثاني 2026راجعه: م. حسن قصاص

الجواب المختصر

أعطِ MaterialApp اللغة ar_SY ومعها مفوّضات GlobalMaterialLocalizations، فيصبح كل عنصر تحته من اليمين لليسار: الصفوف تبدأ من اليمين، وأسهم الرجوع تنقلب، والنص يُحاذى إلى اليمين. لا حاجة لأن تلفّ كل شاشة بعنصر Directionality بنفسك.

ما لا ينقلب وحده: حزمة intl لا تحمل أي بيانات للّغة ar_SY، فترجع بصمت إلى ar العامة. فتظهر التواريخ «نوفمبر» بدل «تشرين الثاني»، حتى في منتقي التاريخ من Material، وتطبع NumberFormat.simpleCurrency علامة £ للّيرة السورية. لكليهما حل قصير في الأسفل. شغّلنا كل شيفرة هنا عبر flutter test على Flutter 3.44 وDart 3.12 وintl 0.20.2 في 16 تشرين الثاني 2026.

الخطوة 1

فعّل العربية للتطبيق كله

أضف flutter_localizations (من الـ SDK) وintl إلى pubspec.yaml، ثم ابنِ التطبيق بلغة العربية السورية. هذه الاستيرادات التي تستخدمها الشيفرات في هذه الصفحة:

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:intl/date_symbol_data_custom.dart';
import 'package:intl/date_symbol_data_local.dart';
import 'package:intl/date_symbols.dart';
import 'package:intl/date_time_patterns.dart';
import 'package:intl/intl.dart' hide TextDirection; // intl has its own TextDirection

const syrianArabic = Locale('ar', 'SY');

/// Locale ar_SY + the Material/Cupertino translations. This alone makes every widget RTL.
MaterialApp syrianApp({required Widget home}) => MaterialApp(
      locale: syrianArabic,
      supportedLocales: const [syrianArabic, Locale('en')],
      localizationsDelegates: GlobalMaterialLocalizations.delegates,
      home: home,
    );

مُختبر: تحت هذا الـ MaterialApp تكون قيمة Directionality.of(context) هي TextDirection.rtl، ويقع أول عنصر في الـ Row على يمين الثاني.

ما ينقلب وحده

التخطيط في RTL: ما يتم تلقائياً وما عليك

في تطبيق RTLماذا تكتب بدلاً منه
Row وWrap وListView الأفقيةيتعاكس الترتيب تلقائياًلا شيء
EdgeInsets.only(left: 16)تبقى على اليسار، أي في الجهة الخطأEdgeInsetsDirectional.only(start: 16)
Alignment.centerLeftتبقى على اليسارAlignmentDirectional.centerStart
Positioned(left: 0)يبقى على اليسارPositionedDirectional(start: 0)
Icons.arrow_back وIcons.arrow_forwardتنعكس تلقائياً (matchTextDirection قيمتها true)لا شيء
صور الأسهم أو ملفات SVG الخاصة بكلا تنعكساقلبها بنفسك عندما يكون Directionality.of(context) هو rtl
حقول الهاتف والبطاقة والرموزتنقلب مع التطبيقtextDirection: TextDirection.ltr على الحقل
الخطوة 2

أسماء الأشهر السورية لا المصرية

الأشهر في سوريا هي كانون الثاني وشباط وآذار وهكذا. المتصفحات تعرف ذلك مع ar-SY، لكن حزمة intl لا تملك بيانات ar_SY: الدالة DateFormat.localeExists('ar_SY') تعيد false وكل تاريخ يرجع إلى ar فيطبع «نوفمبر». سجّل الأسماء السورية مرة واحدة في main() قبل runApp:

const levantineMonths = [
  'كانون الثاني', 'شباط', 'آذار', 'نيسان', 'أيار', 'حزيران',
  'تموز', 'آب', 'أيلول', 'تشرين الأول', 'تشرين الثاني', 'كانون الأول',
];

/// package:intl has no ar_SY data: "ar_SY" silently falls back to "ar" (نوفمبر).
/// Call once in main(), before runApp, to register the Syrian month names.
Future<void> registerSyrianArabic() async {
  await initializeDateFormatting('ar');
  final map = (dateTimeSymbolMap()['ar'] as DateSymbols).serializeToMap()
    ..['NAME'] = 'ar_SY'
    ..['MONTHS'] = levantineMonths
    ..['STANDALONEMONTHS'] = levantineMonths
    ..['SHORTMONTHS'] = levantineMonths
    ..['STANDALONESHORTMONTHS'] = levantineMonths;
  initializeDateFormattingCustom(
    locale: 'ar_SY',
    symbols: DateSymbols.deserializeFromMap(map),
    patterns: dateTimePatternMap()['ar'],
  );
}

مُختبر: قبل التسجيل تعطي DateFormat.MMMM('ar_SY') «نوفمبر»، وبعده تعطي «تشرين الثاني»، وتعطي yMMMMd «5 كانون الثاني 2026»، ويستخدم formatMonthYear في Material الأسماء السورية أيضاً، وتبقى ar العامة كما هي.

الخطوة 3

الأسعار بالليرة السورية بلا علامة £

الدالة NumberFormat.simpleCurrency(locale: 'ar_SY', name: 'SYP') تطبع «1,251 £»: علامة خاطئة، والمبلغ مقرّب إلى ليرة كاملة. وبعد حذف الصفرين قد تحتاج أسعار الليرة الجديدة إلى كسور. حدّد العلامة وعدد الخانات العشرية بنفسك:

/// Prices in Syrian pounds. simpleCurrency(name: 'SYP') prints "£", so set the symbol yourself.
String formatSyp(num amount) =>
    NumberFormat.currency(locale: 'ar', name: 'SYP', symbol: 'ل.س.', decimalDigits: 2).format(amount);

مُختبر: الناتج formatSyp(1250.5) يحوي «1,250.50» و«ل.س.» ولا يحوي £. انتبه إلى أن ar في Dart تستخدم الأرقام الغربية (1,250) بينما تستخدم المتصفحات الأرقام العربية (١٬٢٥٠) مع ar-SY، فاختر واحدة عن قصد. يشرح دليل أسعار الليرة السورية الليرة الجديدة بالتفصيل.

الخطوة 4

أبقِ أرقام الهاتف من اليسار لليمين

رقم الهاتف داخل نموذج عربي يجب أن يُقرأ من اليسار لليمين، وإلا قفزت +963 إلى الطرف الخطأ أثناء الكتابة. ثبّت اتجاه الحقل وحاذِه مع الحقول العربية حوله:

/// A phone number stays left-to-right inside an Arabic form, aligned with the fields around it.
class SyrianPhoneField extends StatelessWidget {
  const SyrianPhoneField({super.key, this.controller});
  final TextEditingController? controller;

  @override
  Widget build(BuildContext context) => TextField(
        controller: controller,
        keyboardType: TextInputType.phone,
        textDirection: TextDirection.ltr,
        textAlign: TextAlign.end,
        decoration: const InputDecoration(labelText: 'رقم الموبايل'),
      );
}

مُختبر: الـ EditableText في الحقل اتجاهه ltr ومحاذاته end ولوحة مفاتيحه للهاتف. وللتحقق مما يكتبه المستخدم، جرّب أداة فحص أرقام الموبايل السورية.

مطبّات

ما واجهناه أثناء الاختبار

  • خطأ «Member not found: 'ltr'» عند البناء. حزمة intl تصدّر صنف TextDirection خاصاً بها يحجب صنف Flutter. استوردها هكذا import 'package:intl/intl.dart' hide TextDirection; في كل ملف يستخدم عناصر Flutter أيضاً.
  • الرجوع من ar_SY إلى ar صامت. لا شيء ينبّهك إلى أن التواريخ تخرج بالأسماء المصرية، ولن يخبرك إلا اختبار أو مستخدم سوري. احتفظ باختبار يفحص اسم شهر سوري واحداً.
  • الحشوة والمحاذاة الفيزيائية (left وright) تبقى كما هي في RTL. ابحث في الشيفرة عن EdgeInsets.only(left وعن Alignment.centerLeft قبل إصدار عربي.
  • النص الذي يكتبه المستخدم قد يبدأ بأي لغة. حدّد اتجاهه من أول حرف قوي، وهي القاعدة نفسها التي يطبّقها ويختبرها دليل RTL للمواقع، ومرّره إلى عنصر Text.
  • شغّل اختبارات الواجهة باللغتين ar_SY وen. أخطاء التخطيط في RTL نادراً ما تظهر إذا كان الفريق يشغّل التطبيق بالإنكليزية فقط.
أسئلة شائعة

أسئلة متكررة

اضبط لغة MaterialApp على لغة عربية مثل ar_SY وأضف GlobalMaterialLocalizations.delegates. عندها يجعل Flutter الاتجاه RTL لكل عنصر في التطبيق، فتنقلب الصفوف والأيقونات ومحاذاة النص دون شيفرة إضافية.

المصادر

من أين جاءت هذه المعلومات

  1. Internationalizing Flutter appsFlutter documentation · accessed 16 Nov 2026
  2. Directionality classFlutter API reference · accessed 16 Nov 2026
  3. EdgeInsetsDirectional classFlutter API reference · accessed 16 Nov 2026
  4. IconData.matchTextDirectionFlutter API reference · accessed 16 Nov 2026
  5. intl packagepub.dev · version 0.20.2
  6. initializeDateFormattingCustomintl API reference · accessed 16 Nov 2026

السلوك مفحوص عبر flutter test (Flutter 3.44 وDart 3.12 وintl 0.20.2) في 16 تشرين الثاني 2026. أعد تشغيل الاختبارات بعد ترقية intl: إن أضافت يوماً بيانات ar_SY يصبح حل أسماء الأشهر غير ضروري.

أدلة وأدوات

تابع القراءة

دليل · العربية واتجاه الكتابةالتواريخ في التطبيقات السورية: كانون الثاني لا ينايريقرأ المستخدم السوري كانون الثاني وشباط وآذار. تعطيك اللغة ar-SY هذه الأسماء، وسوريا على توقيت UTC+3 طوال السنة منذ 2022، والأسبوع يبدأ يوم السبت.دليل · العربية واتجاه الكتابةأسعار الليرة السورية في التطبيقات: الليرة الجديدة والأرقام العربيةكل 100 ليرة قديمة أصبحت ليرة جديدة، لكن رمز العملة ما زال SYP. كيف تخزّن الأسعار السورية وتحوّلها وتعرضها، مع شيفرة مُختبرة وأفخاخ Intl التي يجب تجنّبها.دليل · العربية واتجاه الكتابةبحث عربي يجد «أحمد» عندما يكتب المستخدم «احمد»يكتب الناس الكلمة العربية نفسها بأكثر من طريقة. وحّد النص المخزّن وكلمة البحث بدالة واحدة فيتوقف البحث عن إهمال النتائج. شيفرة مُختبرة بـ JavaScript وDart.دليل · الهندسةكيف تبني تطبيقاً يعمل مع الإنترنت الضعيف في سوريافي سوريا ينقطع الاتصال وتنقطع الكهرباء. هذه القواعد التي نبني بها ليبقى التطبيق مفيداً رغم الاثنين، وكيف تختبر أنه كذلك فعلاً.

تبني تطبيق Flutter لمستخدمين في سوريا؟

أخبرنا عنه. نبني تطبيقات عربية أولاً بـ Flutter ويمكننا مراجعة تطبيقك.