مجموعة الأزرار
أزرار مترابطة مدموجة في عنصر واحد: الجيران يتشاركون الإطار، والزوايا الخارجية وحدها مستديرة. لصف إجراءات، أو إجراء رئيسي مع خياراته، أو حقل مع الإجراء الذي يستخدمه.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add button-groupويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/button-groupأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { ButtonGroup } from "@/components/ui/button-group";import { Button } from "@/components/ui/button";<ButtonGroup aria-label="Message actions"> <Button variant="outline" size="md">Archive</Button> <Button variant="outline" size="md">Report</Button> <Button variant="outline" size="md">Snooze</Button></ButtonGroup>أمثلة
إجراء مع خياراته
الإجراء مع قائمة خياراته هو Split Button، فاستخدم SplitButton: الإجراء ونصف القائمة باسمه الخاص، في عنصر واحد كما في Figma.
مع حقل
حقل والإجراء الذي يستخدمه، مدموجان فيبدو الزر جزءًا من الحقل. التسمية تبقى ظاهرة فوقه، وclassName="items-end" يحاذي المجموعة على صندوق الحقل. لا تضع dir="ltr" على الحقل هنا: يصير صندوقه من اليسار إلى اليمين فتنتقل الزاوية المدموجة؛ وdir="auto" في الحقل يُبقي الرمز اللاتيني من اليسار إلى اليمين أصلًا.
عمودية
orientation="vertical" يدمج من الأعلى إلى الأسفل، مثل أزرار التكبير في الخريطة.
مرجع الخصائص
ButtonGroup
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
aria-label | string | لا يوجد | مطلوب: ما تخصّه الإجراءات («إجراءات الرسالة»)، يُقرأ حين يدخل التركيز المجموعة. |
orientation | "horizontal" | "vertical" | "horizontal" | صف أو عمود. |
children | ReactNode | لا يوجد | أزرار Ritla UI وأزرار الأيقونات وحقل إدخال، بالمقاس نفسه. خاصية Type في Figma هي ما تضعه هنا، لا خاصية. الصف لا يلتف؛ على الهاتف أبقِه ضمن عرض الشاشة: استخدم أزرارًا بحجم sm، أو انقل الإجراءات إلى «إجراءات أخرى». |
ButtonGroupSeparator
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
className | string | لا يوجد | الخط بين زرين ممتلئين؛ مرّر خلفية أخرى لتعبئة أخرى. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | يمر على كل زر بالترتيب، من بداية السطر. |
ARIA
role="group"مسمّى بـaria-label؛ كل زر يحتفظ بدوره واسمه.- زر الأيقونة بلا نص يحتاج اسمًا (
label)، وزر السهم في المجموعة المقسومة اسمه غير اسم الإجراء. - لاختيار خيار واحد من مجموعة استخدم مجموعة أزرار التبديل: الإجراءات هنا لا تبقى مضغوطة.
ملاحظات العربية والاتجاه
ينعكس
- الزر الأول في بداية السطر (اليمين) والزوايا المستديرة معه، والأخير على اليسار.
لا ينعكس
- السهم والنقاط الثلاث لا تنعكس، والقيم اللاتينية في الحقل (رمز الخصم) تبقى من اليسار إلى اليمين.
- الأرقام
- لا أرقام في المجموعة نفسها؛ أي رقم في النصوص يتبع
numerals. - الخط العربي
- كل زر بخطه ومقاسه؛ ارتفاع الصف من الأزرار، فاجعلها بالمقاس نفسه.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.