العرض الدوّار
مجموعة عناصر تُعرض واحدًا تلو الآخر: عروض وتعريف بالتطبيق وأبرز المزايا. الأسهم تنقل عنصرًا واحدًا، والنقاط تبيّن الموضع.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add carouselويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/carouselالاعتماديات التي يضيفها
@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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" للتعريف بالتطبيق: عنصر بعرض كامل، والسهمان حول النقاط.
عناصر فيها روابط
Tab يمرّ على الروابط بالترتيب، والمسار يتمرّر ليبقى الرابط المركّز عليه ظاهرًا.
صور
type="image": صورة واحدة في كل مرة بنسبة 16:10، والسهمان الزجاجيان والنقاط فوقها. size="lg" لصورة كبيرة على سطح المكتب. عند الطرفين يختفي السهم وينتقل التركيز إلى الآخر. لكل CarouselImage نص بديل بلغة الصفحة.
مرجع الخصائص
Carousel
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
type | "cards" | "single" | "image" | "cards" | خاصية Type؛ وimage هي مجموعة Carousel image. |
size | "md" | "lg" | "md" | خاصية Size مع type="image": أسهم 36 أو 44 بكسل. |
title | ReactNode | لا يوجد | عنوان البطاقات بجانب الأسهم، واسم العرض. |
label | string | لا يوجد | اسم العرض لقارئ الشاشة إن لم يكن هناك عنوان نصي. |
children | CarouselSlide[] | لا يوجد | العناصر: خمسة أو أقل، والأهم أولًا. |
CarouselSlide
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
icon | IconComponent | لا يوجد | للبطاقات: أيقونة في مربع brand/faint بزوايا مستديرة. |
artwork | ReactNode | لا يوجد | للعنصر الواحد: محتوى لوحة الرسم بارتفاع 180px. |
title / description | ReactNode | لا يوجد | خاصيتا Heading وBody. |
children | ReactNode | لا يوجد | ما بعد النص: رابط أو زر. |
CarouselImage
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
src | string | لا يوجد | الصورة؛ تملأ الإطار وتُقصّ لتغطيته. |
alt | string | لا يوجد | مطلوب: ما تُظهره الصورة، بلغة الصفحة. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | إلى السهمين ثم المسار ثم النقاط والروابط داخل العناصر. |
| EnterSpace | على سهم: عنصر واحد. على نقطة: ذلك العنصر. |
| ArrowLeftArrowRight | على المسار: تمرير أصلي. |
ARIA
- العرض منطقة لها اسم (
aria-roledescription«عرض دوّار»)، وكل عنصر مجموعة اسمها «2 من 4» (aria-roledescription«عنصر»). - السهمان «العنصر السابق» و«العنصر التالي»، ويتعطلان عند الطرفين (ويختفيان في عرض الصور، بعد نقل التركيز إلى السهم الآخر). النقاط أزرار «انتقل إلى العنصر 2».
- التنقل بالأزرار يُعلن بلطف («العنصر 2 من 4»). لا تشغيل تلقائي.
ملاحظات العربية والاتجاه
ينعكس
- العناصر تبدأ من اليمين، والنقطة النشطة على اليمين.
- السهم المتجه يمينًا يعود إلى العنصر السابق، والسحب يتبع اتجاه القراءة.
- الأيقونات الاتجاهية في الرسوم (الطائرة الورقية) تنعكس.
لا ينعكس
- الأيقونات غير الاتجاهية (العملات، الحصالة) لا تنعكس.
- الأرقام
- أسماء العناصر والنسب في النص تتبع إعداد الأرقام.
- الخط العربي
- العنوان
label-16Semibold، والنصlabel-14. - النص ثنائي الاتجاه
- Ritla UI يعتمد التمرير الأصلي، فيتولى المتصفح اتجاه التمرير بالعربية دون حسابات يدوية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- نصوص سمات غير مترجمة (placeholder وalt وtitle وaria-label وقيمة الزر)
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)