انتقل إلى المحتوى

العرض الدوّار

احصل على Ritla UI

مجموعة عناصر تُعرض واحدًا تلو الآخر: عروض وتعريف بالتطبيق وأبرز المزايا. الأسهم تنقل عنصرًا واحدًا، والنقاط تبيّن الموضع.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add carousel

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/carousel

  2. الاعتماديات التي يضيفها

    @phosphor-icons/react

  3. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

carousel.tsx
import { Carousel, CarouselSlide } from "@/components/ui/carousel";<Carousel title="Offers for you">  <CarouselSlide icon={CoinsIcon} title="Cashback on groceries" description="Get 5% back at partner stores this month." />  <CarouselSlide icon={AirplaneIcon} title="Travel insurance" description="Covered on every trip you pay with Demo Bank." /></Carousel>

أمثلة

عنصر واحد

‏type="single" للتعريف بالتطبيق: عنصر بعرض كامل، والسهمان حول النقاط.

إنجليزيمعكوسعربي
← RTL

صور

‏type="image": صورة واحدة في كل مرة بنسبة 16:10، والسهمان الزجاجيان والنقاط فوقها. size="lg" لصورة كبيرة على سطح المكتب. عند الطرفين يختفي السهم وينتقل التركيز إلى الآخر. لكل CarouselImage نص بديل بلغة الصفحة.

إنجليزيمعكوسعربي
← RTL

مرجع الخصائص

Carousel

الخاصيةالنوعالافتراضيالوصف
type"cards" | "single" | "image""cards"خاصية Type؛ وimage هي مجموعة Carousel image.
size"md" | "lg""md"خاصية Size مع type="image": أسهم 36 أو 44 بكسل.
titleReactNodeلا يوجدعنوان البطاقات بجانب الأسهم، واسم العرض.
labelstringلا يوجداسم العرض لقارئ الشاشة إن لم يكن هناك عنوان نصي.
childrenCarouselSlide[]لا يوجدالعناصر: خمسة أو أقل، والأهم أولًا.

CarouselSlide

الخاصيةالنوعالافتراضيالوصف
iconIconComponentلا يوجدللبطاقات: أيقونة في مربع brand/faint بزوايا مستديرة.
artworkReactNodeلا يوجدللعنصر الواحد: محتوى لوحة الرسم بارتفاع 180px.
title / descriptionReactNodeلا يوجدخاصيتا Heading وBody.
childrenReactNodeلا يوجدما بعد النص: رابط أو زر.

CarouselImage

الخاصيةالنوعالافتراضيالوصف
srcstringلا يوجدالصورة؛ تملأ الإطار وتُقصّ لتغطيته.
altstringلا يوجدمطلوب: ما تُظهره الصورة، بلغة الصفحة.

إمكانية الوصول

لوحة المفاتيح

المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.

المفتاحما يفعله
Tabإلى السهمين ثم المسار ثم النقاط والروابط داخل العناصر.
EnterSpaceعلى سهم: عنصر واحد. على نقطة: ذلك العنصر.
ArrowLeftArrowRightعلى المسار: تمرير أصلي.

ARIA

  • العرض منطقة لها اسم (aria-roledescription «عرض دوّار»)، وكل عنصر مجموعة اسمها «2 من 4» (aria-roledescription «عنصر»).
  • السهمان «العنصر السابق» و«العنصر التالي»، ويتعطلان عند الطرفين (ويختفيان في عرض الصور، بعد نقل التركيز إلى السهم الآخر). النقاط أزرار «انتقل إلى العنصر 2».
  • التنقل بالأزرار يُعلن بلطف («العنصر 2 من 4»). لا تشغيل تلقائي.

ملاحظات العربية والاتجاه

ينعكس

  • العناصر تبدأ من اليمين، والنقطة النشطة على اليمين.
  • السهم المتجه يمينًا يعود إلى العنصر السابق، والسحب يتبع اتجاه القراءة.
  • الأيقونات الاتجاهية في الرسوم (الطائرة الورقية) تنعكس.

لا ينعكس

  • الأيقونات غير الاتجاهية (العملات، الحصالة) لا تنعكس.
الأرقام
أسماء العناصر والنسب في النص تتبع إعداد الأرقام.
الخط العربي
العنوان label-16 Semibold، والنص label-14.
النص ثنائي الاتجاه
‏⁨Ritla UI⁩ يعتمد التمرير الأصلي، فيتولى المتصفح اتجاه التمرير بالعربية دون حسابات يدوية.

الفحوص التي يجتازها

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

  • R012نصوص سمات غير مترجمة (placeholder وalt وtitle وaria-label وقيمة الزر)
  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)