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

OTP input

مدخل لرموز الاستخدام الواحد، بخانة لكل محرف.

المتصفحات
Chrome 123+Firefox 121+Safari 17.5+
الفئة
2
الحجم المضغوط
1.53 kB
ميزانية التخطيط القسري
0 ms
ميزانية axe
0
متوافق مع SSR
نعم
العقد المنشور
بيئة الاختبار

المختبر

OTP Input

افتراضي

API

OtpInput.Root

الخاصيةالنوعافتراضيالوصف
valuestring—الرمز الحالي، ويجعل الحقل متحكّمًا به.
defaultValuestring""الرمز الأولي للحقل غير المتحكّم به.
onValueChange(value: string) => void—تُستدعى بالرمز كلما تغيّر.
onComplete(value: string) => void—تُستدعى حين يبلغ الرمز الطول المضبوط.
lengthnumber6عدد المحارف التي يتّسع لها الرمز.
type"numeric" | "alphanumeric""numeric"المحارف التي يُحتفظ بها عند الكتابة أو اللصق.
maskbooleanfalseيخفي المحارف المُدخلة في الخانات.
disabledbooleanfalseيعطّل المدخل المخفي ويعيّن سمة data-disabled.
autoFocusbooleanfalseيركّز المدخل المخفي عند تثبيت الحقل.
idstring—المعرّف المطبّق على عنصر الجذر المعروض.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

OtpInput.Slot

الخاصيةالنوعافتراضيالوصف
index*number—الموضع من الرمز الذي تعرضه هذه الخانة.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

OtpInput.HiddenInput

الخاصيةالنوعافتراضيالوصف
autoFocusboolean—يركّز هذا المدخل عند التثبيت، متجاوزًا إعداد الجذر.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

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

المفتاحالإجراء
Tabنقل التركيز إلى عنصر التحكم أو منه
Enter / Spaceالتفعيل عند التركيز (لعناصر التحكم الشبيهة بالأزرار)

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

يستخدم HTML الدلالي متى أمكن. افحص بنية HTML المعروضة في المختبر؛ لا تُضاف ARIA إلا حين لا تكفي العناصر الأصلية.

نقاط التنسيق

data-disabled
تُرجمت هذه الصفحة آليًا ولم تُراجع بعد.