منطقة التمرير
إطار ثابت بشريط تمرير نحيف، للقوائم وصفوف البطاقات التي يجب أن تبقى ضمن ارتفاع أو عرض محدد.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add scroll-areaويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/scroll-areaالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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". الإطار أضيق من الصف فتظهر البطاقة الأخيرة جزئيًا، ليعرف الناس أن هناك المزيد. بالعربية يبدأ الصف من اليمين.
داخل بطاقة
bare بلا إطار، داخل بطاقة لها إطارها. عنوان البطاقة ثابت فوق المنطقة، والقائمة وحدها تتمرر.
مرجع الخصائص
ScrollArea
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
orientation | "vertical" | "horizontal" | "both" | "vertical" | خاصية Orientation. |
label | string | لا يوجد | اسم المنطقة لقارئ الشاشة (تصبح region). |
bare | boolean | false | بلا إطار، داخل لوحة أو بطاقة. |
className | string | لا يوجد | للإطار: ارتفاع ثابت (عمودي) أو عرض ثابت (أفقي). |
contentClassName | string | لا يوجد | للمحتوى الذي يتمرر: الحشو والتخطيط. |
إرشادات الاستخدام
منطقة التمرير إطار عرض بارتفاع ثابت وشريط تمرير رفيع فوق المحتوى. هنا: متى تستخدمها، وجهة شريطها في العربية، وما تتحقق منه قبل التسليم.
1. منطقة التمرير
إطار عرض بارتفاع ثابت وشريط تمرير رفيع فوق المحتوى. استخدمها للقوائم والسجلات والقوائم الطويلة داخل بطاقة.
افعل
- تلاشٍ عند الحافتين العليا والسفلى حين يكون هناك محتوى إضافي.
- شريط تمرير بعرض 10 بكسل، ظاهر أثناء التمرير.
تجنّب
- استخدامها للصفحة نفسها.
- إخفاء شريط التمرير على الحاسوب.
2. العربية والاتجاه من اليمين إلى اليسار
يقع شريط التمرير العمودي عند نهاية السطر، أي على اليسار في العربية.
قبل التسليم
- منطقتا التمرير العمودية والأفقية في الاتجاهين.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | إلى المنطقة إن كانت تتمرر، أو إلى أول عنصر داخلها. |
| ArrowUpArrowDownPageUpPageDown | تمرير عمودي. |
| ArrowLeftArrowRight | تمرير أفقي. |
ARIA
- التمرير أصلي، فتعمل لوحة المفاتيح والعجلة واللمس وقارئ الشاشة كما في أي عنصر يتمرر.
- الشريط زخرفي؛ مع
labelتصبح المنطقةregionلها اسم. - لا تلفّ صفحات كاملة بها: للوحات والقوائم والجداول والقوائم الجانبية فقط.
ملاحظات العربية والاتجاه
ينعكس
- الشريط العمودي على اليسار.
- الصفوف الأفقية تبدأ من اليمين، والمقبض يبدأ من اليمين.
لا ينعكس
- رموز العملات تبقى من اليسار إلى اليمين.
- الأرقام
- الأرقام في المحتوى تتبع إعداد الأرقام.
- الخط العربي
- المنطقة لا تفرض خطًا؛ المحتوى يحمل أنماطه.
- النص ثنائي الاتجاه
- الرموز داخل الصفوف العربية في
<bdi dir="ltr">.
افعل
- النسخ العربية، فينتقل شريط التمرير إلى الجهة الأخرى.
تجنّب
- إبقاء شريط التمرير على اليمين في العربية.
- عكس اتجاه التمرير الأفقي للصور أو الرسوم البيانية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.