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

بطاقة الزر

احصل على Ritla UI

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

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add button-card

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

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

    @base-ui/react@phosphor-icons/react

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

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

الاستخدام

button-card.tsx
import { BellIcon } from "@phosphor-icons/react/ssr";import { ButtonCard } from "@/components/ui/button-card";<ButtonCard  iconLeading={BellIcon}  headline="Notifications"  supportingText="Email, push and SMS"  onClick={openNotifications}/>

أمثلة

أنواع البطاقة

horizontal (الافتراضي) بسهم في نهاية السطر، وvertical في المنتصف، وvertical-wide من بداية السطر، وbig-wide بشريط رسم بنسبة 3:1 (illustration) ثم الشعار والنص وسهم في الأسفل. العرض يأتي من التخطيط.

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

خيارات البداية

بطاقات عمودية لخيارات متوازية؛ كل بطاقة تنفّذ إجراءً واحدًا وتنقل إلى الخطوة التالية. اضغط أحدها.

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

إجراءات لوحة التحكم

بطاقات big-wide برسم وشعار في أعلى النص. المبالغ والأعداد تتبع إعداد الأرقام، والسهم ينعكس في العربية والشعار لا.

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

الروابط والتعطيل

البطاقة التي تنقل إلى صفحة رابط: مرّر render={<a href=… />}. disabled يوقفها؛ اكتب السبب في النص المساند.

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

مربّع

variant="tile" مربّع دخول داخل TileGroup: بلا إطار ولا زوايا مستديرة (المجموعة ترسم الخطوط)، عنوان وسطر شرح وسهم في بداية أسفله يتقدّم نحو الوجهة عند التمرير أو التركيز. على الشريط السماوي يتغيّر لونه عند التمرير، ويشتدّ عند الضغط.

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

المربّع بكل الأنواع

variant="tile" يعمل مع كل cardType: التخطيط نفسه بلا إطار ولا زوايا ولا خلفية، ليصطف في شبكة مسطّرة. بلا cardType يكون مربّع الدخول العمودي.

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

مرجع الخصائص

ButtonCard

أي خاصية أخرى من Base UI Button تمر كما هي (onClick، type…).

الخاصيةالنوعالافتراضيالوصف
variant"default" | "tile""default"خاصية Style: tile مربّع دخول لمجموعة TileGroup.
cardType"horizontal" | "vertical" | "vertical-wide" | "big-wide""horizontal"خاصية Card type. في tile الافتراضي vertical، أي مربّع الدخول.
headlineReactNodeلا يوجدمطلوب. Headline، واسم البطاقة لقارئات الشاشة.
overlineReactNodeلا يوجدOverline: سطر صغير فوق العنوان، يظهر إن مُرّر.
supportingTextReactNodeلا يوجدSupporting text: الوصف الذي تقرؤه قارئات الشاشة بعد الاسم.
iconLeadingIconComponentلا يوجدخاصية Icon leading. لا تظهر في big-wide ولا في مربّع الدخول، كما في Figma.
iconTrailingIconComponent | nullCaretRightIcon / ArrowRightIconخاصية Icon trailing: السهم في نهاية البطاقة، ينعكس في العربية. null يخفيه.
illustrationReactNodeلا يوجدخاصية Illustration في big-wide: تملأ شريطًا بنسبة 3:1 فوق النص، ولا تنعكس.
logoReactNodeلا يوجدخاصية Logo في big-wide: شعار في أعلى النص. لا ينعكس.
disabledbooleanfalseState = Disabled.
renderReactElementلا يوجدرابط بشكل البطاقة (<a> أو <Link>)، يحتفظ بدلالته.
classNamestringلا يوجدأصناف إضافية، مثل العرض (w-space-160).

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

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

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

المفتاحما يفعله
Tabينقل التركيز إلى البطاقة وتظهر حلقة التركيز حولها.
EnterSpaceينفّذ الإجراء (Enter فقط للبطاقة الرابط).

ARIA

  • زر أصلي (أو رابط مع render)؛ aria-labelledby يشير إلى العنوان فيكون الاسم قصيرًا، وaria-describedby إلى السطر العلوي والنص المساند.
  • الأيقونات والشعار زخرفية داخل البطاقة؛ مرّر label={null} للشعار.
  • بطاقة واحدة لإجراء واحد: لا تضع أزرارًا أو روابط داخلها.

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

ينعكس

  • البطاقة كلها تنعكس: الأيقونة في بداية السطر (اليمين) والسهم في نهايته (اليسار)، والنص يبدأ من اليمين.
  • CaretRight وArrowRight ينعكسان عبر <Icon> فيشيران إلى الأمام في اللغتين.

لا ينعكس

  • الشعارات لا تنعكس أبدًا، ولا الأيقونات غير الاتجاهية (الجرس، الترس).
الأرقام
المبالغ والأعداد في النصوص («ادفع 3 فواتير») تُنسّق بـformatNumber وتتبع إعداد الأرقام.
الخط العربي
السطر العلوي label-12، والعنوان body-16 بوزن Medium، والنص المساند body-12. البطاقة تتسع لطول النص فلا يُقص العربي.
النص ثنائي الاتجاه
رمز العملة أو اسم لاتيني داخل نص عربي («1840 ريال»، «عبر Apple Pay») يُعرض صحيحًا؛ المعرّفات في <bdi dir="ltr">.

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

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

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