تصفّح التوثيق
English

المكوّنات

رمز التحقق

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

المعاينة

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

التثبيت

قريبًايُفتح التثبيت من السجل مع الإطلاق. حتى ذلك الحين، هذا هو الأمر الذي ستستخدمه.
npx shadcn@latest add @ritla/input-otp

الاعتماديات التي يضيفها: @base-ui/react

الاستخدام

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

أمثلة

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

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

مرجع الخصائص

InputOTP

الخاصيةالنوعالافتراضيالوصف
labelReactNodeخاصية Label.
length4 | 5 | 66خاصيتا Show 5th وShow 6th.
value / defaultValuestringالرمز بأرقام 0-9.
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" للوحة أرقام واقتراح الرمز من الرسالة.

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

ينعكس

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

لا ينعكس

  • الخانات تُقرأ من اليسار إلى اليمين: الرقم الأول في الخانة اليسرى، كما يُكتب الرمز في الرسالة.
الأرقام
الأرقام العربية (٠-٩) والفارسية المكتوبة تُحفظ 0-9، فيعمل الرمز من لوحة مفاتيح عربية.
الخط العربي
label-16 في وسط كل خانة.