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

مجموعة الأزرار

احصل على Ritla UI

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

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add button-group

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

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

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

الاستخدام

button-group.tsx
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.

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

مع حقل

حقل والإجراء الذي يستخدمه، مدموجان فيبدو الزر جزءًا من الحقل. التسمية تبقى ظاهرة فوقه، وclassName="items-end" يحاذي المجموعة على صندوق الحقل. لا تضع dir="ltr" على الحقل هنا: يصير صندوقه من اليسار إلى اليمين فتنتقل الزاوية المدموجة؛ وdir="auto" في الحقل يُبقي الرمز اللاتيني من اليسار إلى اليمين أصلًا.

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

عمودية

orientation="vertical" يدمج من الأعلى إلى الأسفل، مثل أزرار التكبير في الخريطة.

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

مرجع الخصائص

ButtonGroup

الخاصيةالنوعالافتراضيالوصف
aria-labelstringلا يوجدمطلوب: ما تخصّه الإجراءات («إجراءات الرسالة»)، يُقرأ حين يدخل التركيز المجموعة.
orientation"horizontal" | "vertical""horizontal"صف أو عمود.
childrenReactNodeلا يوجدأزرار ⁨Ritla UI⁩ وأزرار الأيقونات وحقل إدخال، بالمقاس نفسه. خاصية Type في Figma هي ما تضعه هنا، لا خاصية. الصف لا يلتف؛ على الهاتف أبقِه ضمن عرض الشاشة: استخدم أزرارًا بحجم sm، أو انقل الإجراءات إلى «إجراءات أخرى».

ButtonGroupSeparator

الخاصيةالنوعالافتراضيالوصف
classNamestringلا يوجدالخط بين زرين ممتلئين؛ مرّر خلفية أخرى لتعبئة أخرى.

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

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

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

المفتاحما يفعله
Tabيمر على كل زر بالترتيب، من بداية السطر.

ARIA

  • role="group" مسمّى بـaria-label؛ كل زر يحتفظ بدوره واسمه.
  • زر الأيقونة بلا نص يحتاج اسمًا (label)، وزر السهم في المجموعة المقسومة اسمه غير اسم الإجراء.
  • لاختيار خيار واحد من مجموعة استخدم مجموعة أزرار التبديل: الإجراءات هنا لا تبقى مضغوطة.

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

ينعكس

  • الزر الأول في بداية السطر (اليمين) والزوايا المستديرة معه، والأخير على اليسار.

لا ينعكس

  • السهم والنقاط الثلاث لا تنعكس، والقيم اللاتينية في الحقل (رمز الخصم) تبقى من اليسار إلى اليمين.
الأرقام
لا أرقام في المجموعة نفسها؛ أي رقم في النصوص يتبع numerals.
الخط العربي
كل زر بخطه ومقاسه؛ ارتفاع الصف من الأزرار، فاجعلها بالمقاس نفسه.

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

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

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