Lorixen.
AR

تطبيق React Native بعد تبديل الاتجاه: لماذا يلزم إعادة التشغيل وأين تقع أخطاء الأنماط

باختصار: في React Native يحدد اتجاه الواجهة عند بدء تشغيل التطبيق، لا أثناء عمله. لذلك إذا بدّل المستخدم اللغة من القائمة داخل التطبيق ثم استدعيت I18nManager.forceRTL(true)، فلن ينقلب شيء فوراً، ويلزم إعادة تشغيل التطبيق بالكامل ليقرأ القيمة الجديدة. وبعد ذلك تظهر أخطاء الأنماط التي تحتفظ بجهات فيزيائية ثابتة. هذه المقالة ترتب لك الأعراض والأسباب والحلول، كما ورد وصف الواجهة في توثيق I18nManager الرسمي.

كيف يتعامل التطبيق مع الاتجاه

عندما يُشغَّل الجهاز بلغة عربية وتسمح للتطبيق بـ RTL، يقلب النظام الواجهة تلقائياً. أما I18nManager فهو الكائن الذي تقرأ منه الحالة الحالية وتغيرها. أهم ما تحتاجه منه:

  • I18nManager.isRTL يخبرك بالاتجاه الذي بدأ به التطبيق فعلاً.
  • I18nManager.allowRTL(true) يسمح للتطبيق بأن يتبع اتجاه لغة الجهاز.
  • I18nManager.forceRTL(true) يفرض RTL بغض النظر عن لغة الجهاز.

الجزء الذي يغفله كثيرون هو أن هذه القيم تُحفظ للتشغيل التالي. تغييرها في منتصف الجلسة لا يعيد رسم الشاشات الجاهزة. ولأن التوثيق يتغير مع الإصدارات، تحقق من صفحة I18nManager الخاصة بإصدارك قبل الاعتماد على تفاصيل هنا.

جدول الأعراض والأسباب والحلول

العرض السبب المرجح الحل
اخترت العربية والواجهة بقيت من اليسار الاتجاه لم يُعاد تحميله بعد احفظ اللغة ثم أعد تشغيل التطبيق
النص عربي لكن الأزرار والقوائم مرتبة بالعكس استخدام row-reverse يدوياً احذفه، فـ row يتبع الاتجاه
مسافة تظهر في الجهة الخطأ marginLeft أو paddingRight ثابتة استخدم marginStart وpaddingEnd
سهم الرجوع يشير للجهة الخطأ أيقونة صورة لا تنعكس اقلبها بـ transform: [{ scaleX: -1 }] عند isRTL
يعمل على أندرويد ويفشل على iOS الإعداد غير متناسق بين المنصتين اختبر الإعداد على المنصتين بشكل منفصل
بعد إعادة التشغيل يعود لليسار لم تُحفظ اللغة قبل التشغيل اقرأ اللغة المحفوظة في بداية التشغيل قبل بناء الواجهة

ماذا تفعل عند تبديل اللغة

الإجراء المضمون تقريباً أن تتبع هذا التسلسل البسيط، وهو توضيحي ويحتاج تعديلاً حسب أدوات تطبيقك:

  1. احفظ اللغة المختارة في تخزين محلي دائم.
  2. إن كان اتجاهها يخالف I18nManager.isRTL الحالي، استدعِ forceRTL بالقيمة الجديدة.
  3. اعرض للمستخدم رسالة قصيرة مثل "سيُعاد تشغيل التطبيق لتطبيق اللغة" بدل أن يرى تغييراً مفاجئاً.
  4. أعد تحميل التطبيق. في مشاريع Expo يمكن استخدام مكتبة التحديثات لإعادة التحميل، وفي المشاريع العادية تُستخدم مكتبة مخصصة لإعادة التشغيل. اختر ما يلائم مشروعك وجرّبه على جهاز حقيقي.

وفكّر في السؤال التالي قبل كل ذلك: هل يحتاج تطبيقك إلى تبديل لغة يدوي فعلاً؟ إذا كان جمهورك يستخدم هواتف بلغة عربية، فاتباع لغة الجهاز يختصر عليك الجزء الأصعب، ويبقى التبديل اليدوي ميزة اختيارية لمن يريدها.

أخطاء الأنماط التي تتكرر

الجهات الفيزيائية

marginLeft وmarginRight وleft وright لا تنقلب مع الاتجاه. يوفر React Native نظائر بمعنى البداية والنهاية مثل marginStart وmarginEnd وpaddingStart وstart. استبدلها تدريجياً كما تفعل في الويب مع الخصائص المنطقية.

محاذاة النص

textAlign: 'left' تبقى يساراً. استخدم 'auto' ليتبع النص لغته، أو اضبطها بحسب isRTL صراحة إن أردت. وحذار من كتابة writingDirection بقيمة ثابتة داخل مكوّن مشترك، فهذا يفرض اتجاهاً على نص قد يكون إنجليزياً.

الحركات والانتقالات

الأنيميشن الذي يحرك عنصراً بـ translateX موجب سيدخل العنصر من الجهة الخطأ في RTL. أنشئ ثابتاً const dir = I18nManager.isRTL ? -1 : 1 واضربه في قيمة الإزاحة.

مكتبات التنقل والقوائم الأفقية

بعض القوائم الأفقية تنعكس تلقائياً وبعضها لا. إذا كانت الصفحة الأولى للقائمة تبدأ من اليسار في الجوال العربي، فراجع إعدادات المكتبة، وإن لم تجد خياراً فاقلب البيانات صراحة بدل أن تعبث بالأنماط.

اختبار سريع قبل الإصدار

هذه قائمة تحقق قصيرة، ويمكن تطبيقها على أي بناء:

  • [ ] شغّل التطبيق على جهاز لغته عربية وعلى آخر لغته إنجليزية، واختبر اختيار العربية يدوياً في الثاني.
  • [ ] افتح الشاشات الخمس الأكثر استخداماً وتأكد أن مسافة البداية والنهاية صحيحة.
  • [ ] أدخل رقم هاتف وبريداً إلكترونياً في نموذج، وتأكد أن الحقل لا يخلط الاتجاه.
  • [ ] جرّب الرجوع بالإيماءة من حافة الشاشة الصحيحة.
  • [ ] راجع الإشعارات والرسائل المنبثقة، فهي تأتي أحياناً بنص ثابت غير مترجم.

ملاحظات عن الاختبار والإصدار

اختبر السيناريو الأصعب: مستخدم يثبّت التطبيق على جهاز لغته إنجليزية، ثم يختار العربية من الإعدادات، ثم يغلق التطبيق من الخلفية ويفتحه. هذا المسار هو ما يخطئ فيه كثير من الفرق لأن المطوّر يختبر غالباً بعد تثبيت جديد. وانتبه إلى المحاكي، فقد يحتفظ بإعدادات اتجاه قديمة بين الجلسات، فامسح بيانات التطبيق كلما شككت في النتيجة. ولا تنسَ شاشة البداية والإشعارات الخارجية، فهي تُرسم قبل أن تحمّل شيفرتك أحياناً وتبقى بالاتجاه الأصلي. دوّن هذه الحالات في ملف الإصدار ليعرفها فريق الدعم قبل أن يصله بلاغ من مستخدم.

ملاحظات عن الاختبار والإصدار

اختبر السيناريو الأصعب: مستخدم يثبّت التطبيق على جهاز لغته إنجليزية، ثم يختار العربية من الإعدادات، ثم يغلق التطبيق من الخلفية ويفتحه. هذا المسار هو ما يخطئ فيه كثير من الفرق لأن المطوّر يختبر غالباً بعد تثبيت جديد. وانتبه إلى المحاكي، فقد يحتفظ بإعدادات اتجاه قديمة بين الجلسات، فامسح بيانات التطبيق كلما شككت في النتيجة. ولا تنسَ شاشة البداية والإشعارات الخارجية، فهي تُرسم قبل أن تحمّل شيفرتك أحياناً وتبقى بالاتجاه الأصلي. دوّن هذه الحالات في ملف الإصدار ليعرفها فريق الدعم قبل أن يصله بلاغ من مستخدم.

أسئلة شائعة

هل يمكن تبديل الاتجاه دون إعادة تشغيل؟

ليس بالأسلوب القياسي. بعض الفرق تبني طبقة تمرر الاتجاه عبر السياق وتعيد بناء الشاشات كلها، لكن ذلك يكلف وقتاً وقد يسبب أخطاء، وغالباً لا يستحق الجهد لتطبيق صغير.

هل يختلف الأمر في Flutter؟

نعم. إطار Flutter يستخدم عنصر Directionality ويعيد بناء الشجرة عند تغيير اللغة، فيكون تبديل اللغة فورياً في الغالب. ما ذكرناه هنا خاص بـ React Native.

هل أحتاج إلى ترجمة الأرقام إلى الهندية؟

ليس بالضرورة. القرار يعود لجمهورك وهوية التطبيق، والأهم أن تكون متسقاً في كل الشاشات.

هل أحتاج إلى مطوّر متخصص؟

يكفي مطوّر React Native يعرف أساسيات الاتجاه. المهم أن يختبر على أجهزة حقيقية بالعربية قبل الإطلاق.

لو كان تطبيقك يعرض واجهة عربية مقلوبة في بعض الشاشات فقط، راسلونا لنحدد المكوّنات التي تحتاج إصلاحاً ونقدّر العمل بوضوح.

المصادر

WhatsAppاحجز مكالمة