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

اللوحات القابلة لتغيير الحجم

احصل على Ritla UI

لوحات يغيّر الناس حجمها بسحب المقبض بينها: محررات متجاورة، وصناديق وارد، ولوحات معلومات.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add resizable

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

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

    @phosphor-icons/react

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

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

الاستخدام

resizable.tsx
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": أعلى وأسفل. السهم للأسفل يطيل اللوحة العليا.

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

متداخل

مجموعة عمودية داخل لوحة. المجموعة الداخلية bare ومقبضها بلا مسكة، كما في Figma.

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

تذكّر الأحجام

‏storageKey يحفظ الأحجام في هذا المتصفح فيبقى التخطيط بعد إعادة التحميل، وonLayoutChange يعطيها لتحفظها لكل مستخدم على خادمك.

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

مرجع الخصائص

ResizableGroup

الخاصيةالنوعالافتراضيالوصف
orientation"horizontal" | "vertical""horizontal"خاصية Layout: متجاورة أو أعلى وأسفل. للتداخل ضع مجموعة داخل لوحة.
storageKeystringلا يوجديحفظ الأحجام في localStorage بهذا المفتاح.
onLayoutChange(sizes: number[]) => voidلا يوجدالأحجام (٪، بالترتيب) بعد كل تغيير.
barebooleanfalseبلا إطار، لمجموعة داخل لوحة.

ResizablePanel

الخاصيةالنوعالافتراضيالوصف
defaultSizenumberلا يوجدالحجم الأول (٪). اللوحات بلا حجم تتقاسم الباقي.
minSizenumber10أصغر حجم (٪)، كي لا ينهار المحتوى.
maxSizenumber100أكبر حجم (٪).

ResizableHandle

الخاصيةالنوعالافتراضيالوصف
withGripbooleanfalseخاصية Grip: حين يكون تغيير الحجم هو المهمة الأساسية.
labelstring"Resize" / «تغيير الحجم»اسم المقبض لقارئ الشاشة.
stepnumber5خطوة مفاتيح الأسهم (٪).

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

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

1. اللوحات القابلة لتغيير الحجم

لوحتان أو ثلاث بمقبض بينها. الأفقي يقسم مساحة عمل؛ والعمودي يقسم محررًا ومخرجاته؛ والمتداخل يفعل الاثنين.

افعل

  • حدّ أدنى للعرض لكل لوحة.
  • تذكّر آخر حجم لكل شخص.

تجنّب

  • مقبض بين أكثر من ثلاث لوحات.
  • تغيير الحجم في المحورين بمقبض واحد.

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

ينعكس ترتيب اللوحات؛ ويحتفظ المقبض بشكل قبضته.

قبل التسليم

  • الأفقي والعمودي والمتداخل معروضة.
  • الحدود الدنيا للأحجام مدوّنة على كل لوحة.

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

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

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

المفتاحما يفعله
Tabإلى المقبض.
ArrowRightArrowLeftيحرّك المقبض بخطوات؛ بالعربية السهم الأيسر يوسّع اللوحة الأولى.
ArrowDownArrowUpفي المجموعة العمودية.
HomeEndإلى أصغر وأكبر حجم للوحة الأولى.

ARIA

  • المقبض role="separator" قابل للتركيز، له aria-valuenow وaria-valuemin وaria-valuemax (حجم اللوحة الأولى) وaria-controls.
  • منطقة سحبه 48px تغطي 24px من كل لوحة، داخل حشوها.

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

ينعكس

  • اللوحة الأولى على اليمين.
  • السحب والأسهم تتبع اتجاه القراءة.

لا ينعكس

  • المجموعات العمودية لا تتغير، ونقاط المسكة لا تنعكس.
الأرقام
الأحجام المعلنة تتبع إعداد الأرقام في واجهتك.
الخط العربي
المجموعة لا تفرض خطًا؛ اللوحات تحمل محتواها.
النص ثنائي الاتجاه
‏⁨Ritla UI⁩ يبني المقسّم بنفسه لأن البدائل الشائعة تثبّت السهم الأيسر على تصغير اللوحة الأولى حتى بالعربية.

افعل

  • النسخ العربية، فينعكس ترتيب اللوحات.
  • تحقّق أن اللوحة الأولى ما زالت اللوحة الرئيسية.

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

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

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