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

منطقة التمرير

احصل على Ritla UI

إطار ثابت بشريط تمرير نحيف، للقوائم وصفوف البطاقات التي يجب أن تبقى ضمن ارتفاع أو عرض محدد.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add scroll-area

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

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

    @base-ui/react

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

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

الاستخدام

scroll-area.tsx
import { ScrollArea } from "@/components/ui/scroll-area";<ScrollArea label="Currencies" className="h-space-320 w-space-256" contentClassName="px-space-20 py-space-16">  …</ScrollArea>

أمثلة

صف بطاقات

‏orientation="horizontal". الإطار أضيق من الصف فتظهر البطاقة الأخيرة جزئيًا، ليعرف الناس أن هناك المزيد. بالعربية يبدأ الصف من اليمين.

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

داخل بطاقة

‏bare بلا إطار، داخل بطاقة لها إطارها. عنوان البطاقة ثابت فوق المنطقة، والقائمة وحدها تتمرر.

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

مرجع الخصائص

ScrollArea

الخاصيةالنوعالافتراضيالوصف
orientation"vertical" | "horizontal" | "both""vertical"خاصية Orientation.
labelstringلا يوجداسم المنطقة لقارئ الشاشة (تصبح region).
barebooleanfalseبلا إطار، داخل لوحة أو بطاقة.
classNamestringلا يوجدللإطار: ارتفاع ثابت (عمودي) أو عرض ثابت (أفقي).
contentClassNamestringلا يوجدللمحتوى الذي يتمرر: الحشو والتخطيط.

إرشادات الاستخدام

منطقة التمرير إطار عرض بارتفاع ثابت وشريط تمرير رفيع فوق المحتوى. هنا: متى تستخدمها، وجهة شريطها في العربية، وما تتحقق منه قبل التسليم.

1. منطقة التمرير

إطار عرض بارتفاع ثابت وشريط تمرير رفيع فوق المحتوى. استخدمها للقوائم والسجلات والقوائم الطويلة داخل بطاقة.

افعل

  • تلاشٍ عند الحافتين العليا والسفلى حين يكون هناك محتوى إضافي.
  • شريط تمرير بعرض 10 بكسل، ظاهر أثناء التمرير.

تجنّب

  • استخدامها للصفحة نفسها.
  • إخفاء شريط التمرير على الحاسوب.

2. العربية والاتجاه من اليمين إلى اليسار

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

قبل التسليم

  • منطقتا التمرير العمودية والأفقية في الاتجاهين.

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

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

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

المفتاحما يفعله
Tabإلى المنطقة إن كانت تتمرر، أو إلى أول عنصر داخلها.
ArrowUpArrowDownPageUpPageDownتمرير عمودي.
ArrowLeftArrowRightتمرير أفقي.

ARIA

  • التمرير أصلي، فتعمل لوحة المفاتيح والعجلة واللمس وقارئ الشاشة كما في أي عنصر يتمرر.
  • الشريط زخرفي؛ مع label تصبح المنطقة region لها اسم.
  • لا تلفّ صفحات كاملة بها: للوحات والقوائم والجداول والقوائم الجانبية فقط.

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

ينعكس

  • الشريط العمودي على اليسار.
  • الصفوف الأفقية تبدأ من اليمين، والمقبض يبدأ من اليمين.

لا ينعكس

  • رموز العملات تبقى من اليسار إلى اليمين.
الأرقام
الأرقام في المحتوى تتبع إعداد الأرقام.
الخط العربي
المنطقة لا تفرض خطًا؛ المحتوى يحمل أنماطه.
النص ثنائي الاتجاه
الرموز داخل الصفوف العربية في <bdi dir="ltr">.

افعل

  • النسخ العربية، فينتقل شريط التمرير إلى الجهة الأخرى.

تجنّب

  • إبقاء شريط التمرير على اليمين في العربية.
  • عكس اتجاه التمرير الأفقي للصور أو الرسوم البيانية.

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

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

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