بيانات البطاقة
رقم البطاقة وتاريخ الانتهاء ورمز الأمان في مجموعة واحدة، تُنسَّق أثناء الكتابة وتملؤها المتصفحات والمحافظ.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 40 من 41مقاسات العرض: 3تاريخ الفحص: قراءة خاطئة معروفة في محرّك الفحص لدينا: R023
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add card-detailsويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/card-detailsالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { CardDetails } from "@/components/ui/card-details";<CardDetails label="Card details" onValueChange={(card, { brand, complete }) => setCard(card)} />أمثلة
الخطأ والتعطيل
errorPart يحدد الجزء الخاطئ (number أو expiry أو cvc)، والرسالة تحت المجموعة.
مرجع الخصائص
CardDetails
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | ReactNode | لا يوجد | خاصية Label. |
value / defaultValue | { number, expiry, cvc } | لا يوجد | القيم (الرقم بلا مسافات، والتاريخ MM/YY). |
onValueChange | (card, { brand, complete }) => void | لا يوجد | مع كل تغيير: الشبكة (visa، mastercard…) واكتمال البيانات مع فحص Luhn. |
error / errorPart | ReactNode / "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"باسم التسمية، ولكل جزء اسم («رقم البطاقة»، «تاريخ الانتهاء (شهر/سنة)»، «رمز الأمان») بلغة الصفحة. autocompletecc-number وcc-exp وcc-csc لتعبئة المتصفح والمحفظة، وinputmode="numeric".- الجزء الخاطئ يحمل
aria-invalid، والرسالة مرتبطة بالأجزاء كلها.
ملاحظات العربية والاتجاه
ينعكس
- التسمية والنص المساعد في بداية السطر (اليمين).
لا ينعكس
- المجموعة من اليسار إلى اليمين كما تُطبع البطاقة: الرقم أعلى، والتاريخ يسارًا والرمز يمينًا، في العربية أيضًا.
- الأرقام
- الأرقام المشرقية والفارسية المكتوبة تُحفظ بأرقام غربية (
0123456789) وتظهر بها، كما على البطاقة. - الخط العربي
label-16كبقية الحقول.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
- حاوية مجبرة على الاتجاه من اليسار، أو تجاوز لخوارزمية الاتجاه، فوق محتوى عربي
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة