דילוג לתוכן
uiify

OTP input

שדה לקודים חד-פעמיים, עם תא לכל תו.

דפדפנים
Chrome 123+Firefox 121+Safari 17.5+
שכבה
2
גודל חבילה דחוסה
1.67 kB
מגבלת פריסה כפויה
0 ms
מגבלת Axe
0
תואם SSR
כן
חוזה מפורסם
סביבת בדיקות

מגרש ניסויים

API

OtpInput.Root

מאפייןטיפוסברירת מחדלתיאור
size"sm" | "md" | "lg""md"גובה הפקד וגודל הטקסט, בהתאמה ל-Button (32, 40 או 48 px); נכתבים ל-data-size, עם md כשלא הוגדר ערך.
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 סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.

נקודות חיבור לעיצוב

data-disabled
דף זה תורגם אוטומטית וטרם נבדק.