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 כשלא הוגדר ערך. |
value | string | — | הקוד הנוכחי, ההופך את השדה למבוקר. |
defaultValue | string | "" | הקוד ההתחלתי של השדה הלא מבוקר. |
onValueChange | (value: string) => void | — | נקראת עם הקוד בכל שינוי בו. |
onComplete | (value: string) => void | — | נקראת כשהקוד מגיע לאורך שהוגדר. |
length | number | 6 | מספר התווים שהקוד מכיל. |
type | "numeric" | "alphanumeric" | "numeric" | התווים שנשמרים בעת הקלדה או הדבקה. |
mask | boolean | false | מסתיר את התווים שהוזנו במשבצות. |
disabled | boolean | false | משבית את הקלט המוסתר ומגדיר את המאפיין data-disabled. |
autoFocus | boolean | false | ממקד את הקלט המוסתר כשהשדה נטען. |
id | string | — | המזהה המוחל על אלמנט השורש המוצג. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
OtpInput.Slot
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
index* | number | — | המיקום בקוד שמשבצת זו מציגה. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
OtpInput.HiddenInput
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
autoFocus | boolean | — | ממקד קלט זה בעת הטעינה, תוך עקיפת הגדרת השורש. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד אל הפקד או ממנו |
| Enter / Space | הפעלה כשהפקד ממוקד (פקדים דמויי כפתור) |
נגישות
משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.
נקודות חיבור לעיצוב
data-disabled