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

رمز التحقق

احصل على Ritla UI

خانات رمز لمرة واحدة، من 4 إلى 6. الكتابة تنتقل للخانة التالية، واللصق يملؤها كلها، والهاتف يقترح الرمز من الرسالة.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add input-otp

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

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

    @base-ui/react

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

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

الاستخدام

input-otp.tsx
import { InputOTP } from "@/components/ui/input-otp";<InputOTP label="Verification code" onValueComplete={verify} />

أمثلة

الطول والحالات

length: ‏4 أو 5 أو 6. الخطأ يلوّن كل الخانات.

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

مرجع الخصائص

InputOTP

الخاصيةالنوعالافتراضيالوصف
labelReactNodeلا يوجدخاصية Label.
length4 | 5 | 66خاصيتا Show 5th وShow 6th.
value / defaultValuestringلا يوجدالرمز بأرقام غربية (0123456789).
onValueChange(value: string) => voidلا يوجدعند كل تغيير.
onValueComplete(value: string) => voidلا يوجدعند امتلاء كل الخانات.
autoSubmitbooleanfalseإرسال النموذج عند اكتمال الرمز.
required / helperText / error / disabled / readOnly / name…لا يوجدكما في حقل الإدخال.

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

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

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

المفتاحما يفعله
0…9يكتب الرقم وينتقل للخانة التالية.
Backspaceيمسح ويعود خانة.
ArrowLeftArrowRightبين الخانات، بالاتجاه المرئي نفسه في العربية (الخانات من اليسار إلى اليمين).

ARIA

  • الخانة الأولى تأخذ اسم التسمية، والباقية «الرقم 2 من 6» بلغة الصفحة.
  • autocomplete="one-time-code" وinputmode="numeric" للوحة أرقام واقتراح الرمز من الرسالة.

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

ينعكس

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

لا ينعكس

  • الخانات تُقرأ من اليسار إلى اليمين: الرقم الأول في الخانة اليسرى، كما يُكتب الرمز في الرسالة.
الأرقام
الأرقام المشرقية (٠١٢٣٤٥٦٧٨٩) والفارسية المكتوبة تُحفظ بأرقام غربية (0123456789)، فيعمل الرمز من لوحة مفاتيح عربية.
الخط العربي
label-16 في وسط كل خانة.

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

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

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