Lorixen.
AR

سلايدر الصور يتحرك بالعكس في موقعك العربي: Swiper وRTL

باختصار: إذا كان سلايدر الصور في موقعك العربي يتحرك بعكس ما يتوقعه الزبون، فيسحب إصبعه نحو اليسار ليرى الصورة التالية فتعود السابقة، أو تبدأ النقاط من اليسار، أو يتقدم العرض التلقائي نحو الجهة الخطأ، فالمشكلة غالباً أن المكتبة لا تعرف أن الصفحة من اليمين إلى اليسار. في Swiper يوجد لهذا دعم صريح: خاصية swiper.rtl، ودالة changeLanguageDirection التي تقبل rtl أو ltr، ومثال RTL رسمي في صفحة العروض. اجعل الاتجاه واضحاً للمكتبة، ثم راجع العرض التلقائي وأسهم التنقل ورسائل قارئ الشاشة بالعربية.

كيف تظهر المشكلة في متجر حقيقي

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

بالنسبة للزبون، هذه ليست مشكلة تقنية بل إحساس بأن الموقع «مقلوب». وبعضهم يتوقف عند الصورة الأولى ظاناً أنها الوحيدة.

ما الذي يتوقعه القارئ العربي

في واجهة من اليمين إلى اليسار، البداية على اليمين. أي أن:

  • الصورة الأولى هي التي تظهر، والتالية «تأتي» من جهة اليسار.
  • السهم الذي يشير إلى اليسار يعني «التالي»، والذي يشير إلى اليمين يعني «السابق».
  • نقاط الترقيم تبدأ من اليمين.
  • السحب بالإصبع نحو اليمين يعيد ما سبق، ونحو اليسار يتقدم.

لا داعي لاختراع اتجاه جديد. المطلوب أن يتطابق السلايدر مع اتجاه بقية الصفحة.

ما يوفره Swiper للاتجاه

توثيق واجهة Swiper البرمجية يذكر عدة نقاط تخص الاتجاه:

  • swiper.rtl: خاصية منطقية على كائن السلايدر، تفيد في الفحص لمعرفة هل يعمل السلايدر باتجاه من اليمين إلى اليسار.
  • swiper.changeLanguageDirection(direction): دالة يصفها التوثيق بأنها تغيّر اتجاه لغة السلايدر، والقيمة الجديدة يجب أن تكون rtl أو ltr. هذه مفيدة في موقع ثنائي اللغة يبدّل اللغة دون إعادة تحميل الصفحة.
  • changeDirection: دالة أخرى بالاسم القريب، لكنها لشيء مختلف: يقول التوثيق إنها تغيّر اتجاه السلايدر من أفقي إلى رأسي وبالعكس. لا تخلط بينهما.

وفي صفحة العروض الرسمية للمكتبة مثال باسم Rtl يمكن فتحه ومقارنته بإعدادك. في الاستخدام الشائع تأخذ المكتبة الاتجاه من خاصية dir على عنصر السلايدر أو الصفحة، فإذا كانت صفحتك dir="rtl" وما زال السلايدر يتصرف كأنه إنجليزي، فتأكد أن الخاصية موجودة فعلاً على العنصر أو أحد آبائه عند إنشاء السلايدر، وراجع المثال الرسمي لإصدارك.

مثال توضيحي للإعداد

مثال توضيحي لسلايدر صور منتج في صفحة عربية:

<div class="swiper product-gallery" dir="rtl">
  <div class="swiper-wrapper">
    <div class="swiper-slide"><img src="sofa-front.jpg" alt="الكنبة من الأمام"></div>
    <div class="swiper-slide"><img src="sofa-side.jpg" alt="الكنبة من الجانب"></div>
  </div>
  <div class="swiper-pagination"></div>
</div>
const gallery = new Swiper('.product-gallery', {
  a11y: { prevSlideMessage: 'الصورة السابقة', nextSlideMessage: 'الصورة التالية' }
});
console.log(gallery.rtl);

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

رسائل قارئ الشاشة بالعربية

يوفر Swiper وحدة لإمكانية الوصول اسمها a11y، ويعرض التوثيق مثالاً يضبط فيه prevSlideMessage وnextSlideMessage، وقيمها الافتراضية في المثال إنجليزية: «Previous slide» و«Next slide». في موقع عربي، قارئ الشاشة سيقرأ هذه الكلمات الإنجليزية لزبون عربي ما لم تغيّرها. وتذكر وثيقة الواجهة أيضاً رسالة للحاوية containerMessage يمكن ضبطها.

العرض التلقائي يحتاج انتباهاً خاصاً

إن كان السلايدر في الصفحة الرئيسية يعرض عروض المحل تلقائياً، فراجع خيارات autoplay في التوثيق:

  • delay: المدة بين الانتقالات بالمللي ثانية.
  • reverseDirection: يفعّل العرض التلقائي بالاتجاه المعاكس. إن وجدت أن مطوراً سابقاً فعّله ليصلح الاتجاه في الموقع العربي، فهذا ترقيع: الأفضل أن يعرف السلايدر أنه RTL، وأن تبقى هذه القيمة على الافتراض.
  • disableOnInteraction: قيمته الافتراضية true، أي يتوقف العرض التلقائي بعد تفاعل المستخدم بالسحب.
  • pauseOnMouseEnter: عند تفعيله يتوقف العرض حين يمر مؤشر الفأرة فوق السلايدر.

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

ترتيب الصور نفسه جزء من الحل

حتى بعد ضبط الاتجاه، ترتيب الصور يحدد ما يراه الزبون أولاً. في صفحة منتج، اجعل الصورة الأولى هي التي تجيب عن السؤال الأهم: كيف يبدو المنتج كاملاً؟ ثم التفاصيل: القماش، والأرجل، والأبعاد. وفي الصفحة الرئيسية، ضع العرض الأهم أولاً، لأن كثيراً من الزوار لا يتجاوزون الشريحة الأولى.

واكتب لكل صورة نصاً بديلاً يصف محتواها فعلاً، مثل «الكنبة من الجانب تظهر عمق المقعد»، لا «صورة 2». هذا يفيد قارئ الشاشة، ويفيد أيضاً عندما تفشل الصورة في التحميل على شبكة ضعيفة. ولا تكتب نص العرض المهم داخل الصورة فقط، مثل «خصم على غرف النوم»، لأن النص المحفور في الصورة لا يقرؤه قارئ الشاشة ولا محرك البحث، ولا يُترجم عند تبديل اللغة.

حين يكون السلايدر داخل تبويب أو نافذة منبثقة

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

اختبار من دقيقتين قبل النشر

  1. افتح صفحة منتج على جوال حقيقي، واسحب للأمام والخلف.
  2. اضغط الأسهم وتأكد أن السهم المشير إلى اليسار يتقدم.
  3. راقب النقاط: هل تبدأ من اليمين؟
  4. شغّل قارئ الشاشة في الجوال واستمع لاسم الأزرار.
  5. إن كان الموقع ثنائي اللغة، بدّل اللغة وكرر الاختبار، لأن السلايدر يجب أن ينقلب مع الصفحة.
  6. اختبر حالة صورة واحدة فقط، فبعض المنتجات ليس لها إلا صورة، ولا يجب أن تظهر أسهم لا تفعل شيئاً.

أسئلة شائعة

هل يكفي قلب الأسهم بـ CSS؟

لا. قلب شكل السهم لا يغيّر منطق التقدم والسحب والنقاط. الحل أن يعمل السلايدر نفسه باتجاه RTL.

الموقع ثنائي اللغة، هل أحتاج سلايدرين؟

لا. توثيق Swiper يذكر دالة changeLanguageDirection لتغيير الاتجاه إلى rtl أو ltr، فيمكن استدعاؤها عند تبديل اللغة.

لماذا يقرأ قارئ الشاشة «Next slide» بالإنجليزية؟

لأن رسائل وحدة a11y الافتراضية إنجليزية في مثال التوثيق. اضبطها بالعربية في الإعدادات.

هل هذا خاص بـ Swiper؟

المبدأ عام لكل مكتبات السلايدر: يجب أن تعرف المكتبة الاتجاه. لكن أسماء الخيارات تختلف، فراجع توثيق مكتبتك.

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

المصادر

WhatsAppاحجز مكالمة