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

بيانات البطاقة

احصل على Ritla UI

رقم البطاقة وتاريخ الانتهاء ورمز الأمان في مجموعة واحدة، تُنسَّق أثناء الكتابة وتملؤها المتصفحات والمحافظ.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 40 من 41مقاسات العرض: 3تاريخ الفحص: قراءة خاطئة معروفة في محرّك الفحص لدينا: R023

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add card-details

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

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

    @base-ui/react

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

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

الاستخدام

card-details.tsx
import { CardDetails } from "@/components/ui/card-details";<CardDetails label="Card details" onValueChange={(card, { brand, complete }) => setCard(card)} />

أمثلة

الخطأ والتعطيل

errorPart يحدد الجزء الخاطئ (number أو expiry أو cvc)، والرسالة تحت المجموعة.

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

مرجع الخصائص

CardDetails

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدخاصية Label.
value / defaultValue{ number, expiry, cvc }لا يوجدالقيم (الرقم بلا مسافات، والتاريخ MM/YY).
onValueChange(card, { brand, complete }) => voidلا يوجدمع كل تغيير: الشبكة (visa، mastercard…) واكتمال البيانات مع فحص Luhn.
error / errorPartReactNode / "number" | "expiry" | "cvc"لا يوجدخاصيتا State = Error وField. بدون errorPart تُعلَّم الأجزاء الثلاثة.
partLabels{ number?, expiry?, cvc? }لا يوجدأسماء الأجزاء لقارئ الشاشة. الافتراضي بلغة الصفحة.
names{ number?, expiry?, cvc? }cc-number, cc-exp, cc-cscأسماء الحقول في النموذج.
required / helperText / disabled…لا يوجدكما في حقل الإدخال.

cardBrand / isValidCardNumber

الخاصيةالنوعالافتراضيالوصف
cardBrand(number)CardBrandلا يوجدالشبكة من أول الأرقام. بطاقات مدى مشتركة مع Visa أو Mastercard وتُقرأ كذلك.
isValidCardNumber(number)booleanلا يوجدفحص Luhn والطول.

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

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

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

المفتاحما يفعله
Tabالرقم، ثم التاريخ، ثم الرمز.

ARIA

  • المجموعة role="group" باسم التسمية، ولكل جزء اسم («رقم البطاقة»، «تاريخ الانتهاء (شهر/سنة)»، «رمز الأمان») بلغة الصفحة.
  • autocomplete ‏cc-number وcc-exp وcc-csc لتعبئة المتصفح والمحفظة، وinputmode="numeric".
  • الجزء الخاطئ يحمل aria-invalid، والرسالة مرتبطة بالأجزاء كلها.

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

ينعكس

  • التسمية والنص المساعد في بداية السطر (اليمين).

لا ينعكس

  • المجموعة من اليسار إلى اليمين كما تُطبع البطاقة: الرقم أعلى، والتاريخ يسارًا والرمز يمينًا، في العربية أيضًا.
الأرقام
الأرقام المشرقية والفارسية المكتوبة تُحفظ بأرقام غربية (0123456789) وتظهر بها، كما على البطاقة.
الخط العربي
label-16 كبقية الحقول.

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

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

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