رمز التحقق
خانات رمز لمرة واحدة، من 4 إلى 6. الكتابة تنتقل للخانة التالية، واللصق يملؤها كلها، والهاتف يقترح الرمز من الرسالة.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 40 من 41مقاسات العرض: 3تاريخ الفحص: قراءة خاطئة معروفة في محرّك الفحص لدينا: R023
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add input-otpويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/input-otpالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { InputOTP } from "@/components/ui/input-otp";<InputOTP label="Verification code" onValueComplete={verify} />أمثلة
مرجع الخصائص
InputOTP
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
label | ReactNode | لا يوجد | خاصية Label. |
length | 4 | 5 | 6 | 6 | خاصيتا Show 5th وShow 6th. |
value / defaultValue | string | لا يوجد | الرمز بأرقام غربية (0123456789). |
onValueChange | (value: string) => void | لا يوجد | عند كل تغيير. |
onValueComplete | (value: string) => void | لا يوجد | عند امتلاء كل الخانات. |
autoSubmit | boolean | false | إرسال النموذج عند اكتمال الرمز. |
required / helperText / error / disabled / readOnly / name | … | لا يوجد | كما في حقل الإدخال. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| 0…9 | يكتب الرقم وينتقل للخانة التالية. |
| Backspace | يمسح ويعود خانة. |
| ArrowLeftArrowRight | بين الخانات، بالاتجاه المرئي نفسه في العربية (الخانات من اليسار إلى اليمين). |
ARIA
- الخانة الأولى تأخذ اسم التسمية، والباقية «الرقم 2 من 6» بلغة الصفحة.
autocomplete="one-time-code"وinputmode="numeric"للوحة أرقام واقتراح الرمز من الرسالة.
ملاحظات العربية والاتجاه
ينعكس
- المجموعة تبدأ من بداية السطر (اليمين) مع التسمية.
لا ينعكس
- الخانات تُقرأ من اليسار إلى اليمين: الرقم الأول في الخانة اليسرى، كما يُكتب الرمز في الرسالة.
- الأرقام
- الأرقام المشرقية (
٠١٢٣٤٥٦٧٨٩) والفارسية المكتوبة تُحفظ بأرقام غربية (0123456789)، فيعمل الرمز من لوحة مفاتيح عربية. - الخط العربي
label-16في وسط كل خانة.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
- حاوية مجبرة على الاتجاه من اليسار، أو تجاوز لخوارزمية الاتجاه، فوق محتوى عربي
- مخاطر اتجاه غير معزولة: أرقام هواتف وبريد إلكتروني ومقاطع لاتينية داخل نص عربي
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة