Number field
שדה קלט מספרי עם כפתורי הגדלה והקטנה.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 1
- גודל חבילה דחוסה
- 2.58 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
NumberField.Root
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
value | number | — | המספר הנוכחי, ההופך את השדה למבוקר. |
defaultValue | number | — | המספר ההתחלתי של השדה הלא מבוקר. |
onValueChange | (value: number | undefined) => void | — | נקראת עם המספר שפוענח, או undefined כשהקלט ריק. |
min | number | — | הערך הנמוך ביותר המותר. |
max | number | — | הערך הגבוה ביותר המותר. |
step | number | 1 | הכמות שמוסיפים או מפחיתים כפתורי ההגדלה וההקטנה. |
formatOptions | Intl.NumberFormatOptions | — | אפשרויות עבור Intl.NumberFormat המשמש להצגת הערך. |
clampValueOnBlur | boolean | true | מחזיר ערך החורג מהטווח אל בין min ו-max כשהקלט מאבד מיקוד. |
disabled | boolean | false | משבית את הקלט ואת שני כפתורי שינוי הערך. |
readOnly | boolean | false | הופך את הערך לקריאה בלבד, תוך שמירה על האפשרות למקד את הקלט. |
required | boolean | false | מסמן את הקלט כנדרש לצורך אימות הטופס. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
NumberField.Group
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | הקלט וכפתורי שינוי הערך העטופים בקבוצה. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
NumberField.Input
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
NumberField.Increment
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | תוכן כפתור ההגדלה. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
NumberField.Decrement
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | תוכן כפתור ההקטנה. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד אל הפקד או ממנו |
| Enter / Space | הפעלה כשהפקד ממוקד (פקדים דמויי כפתור) |
נגישות
משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.
נקודות חיבור לעיצוב
data-uiify-number-fielddata-disabled