اللوحات القابلة لتغيير الحجم
لوحات يغيّر الناس حجمها بسحب المقبض بينها: محررات متجاورة، وصناديق وارد، ولوحات معلومات.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add resizableويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/resizableالاعتماديات التي يضيفها
@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { ResizableGroup, ResizableHandle, ResizablePanel } from "@/components/ui/resizable";<ResizableGroup> <ResizablePanel defaultSize={36} minSize={20}>Sidebar</ResizablePanel> <ResizableHandle withGrip /> <ResizablePanel minSize={30}>Content</ResizablePanel></ResizableGroup>أمثلة
عمودي
orientation="vertical": أعلى وأسفل. السهم للأسفل يطيل اللوحة العليا.
متداخل
مجموعة عمودية داخل لوحة. المجموعة الداخلية bare ومقبضها بلا مسكة، كما في Figma.
تذكّر الأحجام
storageKey يحفظ الأحجام في هذا المتصفح فيبقى التخطيط بعد إعادة التحميل، وonLayoutChange يعطيها لتحفظها لكل مستخدم على خادمك.
مرجع الخصائص
ResizableGroup
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
orientation | "horizontal" | "vertical" | "horizontal" | خاصية Layout: متجاورة أو أعلى وأسفل. للتداخل ضع مجموعة داخل لوحة. |
storageKey | string | لا يوجد | يحفظ الأحجام في localStorage بهذا المفتاح. |
onLayoutChange | (sizes: number[]) => void | لا يوجد | الأحجام (٪، بالترتيب) بعد كل تغيير. |
bare | boolean | false | بلا إطار، لمجموعة داخل لوحة. |
ResizablePanel
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
defaultSize | number | لا يوجد | الحجم الأول (٪). اللوحات بلا حجم تتقاسم الباقي. |
minSize | number | 10 | أصغر حجم (٪)، كي لا ينهار المحتوى. |
maxSize | number | 100 | أكبر حجم (٪). |
ResizableHandle
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
withGrip | boolean | false | خاصية Grip: حين يكون تغيير الحجم هو المهمة الأساسية. |
label | string | "Resize" / «تغيير الحجم» | اسم المقبض لقارئ الشاشة. |
step | number | 5 | خطوة مفاتيح الأسهم (٪). |
إرشادات الاستخدام
اللوحات القابلة لتغيير الحجم تقسم مساحة عمل بمقبض بينها. هنا: متى تستخدمها، وترتيبها في العربية، وما تتحقق منه قبل التسليم.
1. اللوحات القابلة لتغيير الحجم
لوحتان أو ثلاث بمقبض بينها. الأفقي يقسم مساحة عمل؛ والعمودي يقسم محررًا ومخرجاته؛ والمتداخل يفعل الاثنين.
افعل
- حدّ أدنى للعرض لكل لوحة.
- تذكّر آخر حجم لكل شخص.
تجنّب
- مقبض بين أكثر من ثلاث لوحات.
- تغيير الحجم في المحورين بمقبض واحد.
2. العربية والاتجاه من اليمين إلى اليسار
ينعكس ترتيب اللوحات؛ ويحتفظ المقبض بشكل قبضته.
قبل التسليم
- الأفقي والعمودي والمتداخل معروضة.
- الحدود الدنيا للأحجام مدوّنة على كل لوحة.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | إلى المقبض. |
| ArrowRightArrowLeft | يحرّك المقبض بخطوات؛ بالعربية السهم الأيسر يوسّع اللوحة الأولى. |
| ArrowDownArrowUp | في المجموعة العمودية. |
| HomeEnd | إلى أصغر وأكبر حجم للوحة الأولى. |
ARIA
- المقبض
role="separator"قابل للتركيز، لهaria-valuenowوaria-valueminوaria-valuemax(حجم اللوحة الأولى) وaria-controls. - منطقة سحبه 48px تغطي 24px من كل لوحة، داخل حشوها.
ملاحظات العربية والاتجاه
ينعكس
- اللوحة الأولى على اليمين.
- السحب والأسهم تتبع اتجاه القراءة.
لا ينعكس
- المجموعات العمودية لا تتغير، ونقاط المسكة لا تنعكس.
- الأرقام
- الأحجام المعلنة تتبع إعداد الأرقام في واجهتك.
- الخط العربي
- المجموعة لا تفرض خطًا؛ اللوحات تحمل محتواها.
- النص ثنائي الاتجاه
- Ritla UI يبني المقسّم بنفسه لأن البدائل الشائعة تثبّت السهم الأيسر على تصغير اللوحة الأولى حتى بالعربية.
افعل
- النسخ العربية، فينعكس ترتيب اللوحات.
- تحقّق أن اللوحة الأولى ما زالت اللوحة الرئيسية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.