Field
מעטפת לתווית, לפקד ולהודעת שגיאה.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 0
- גודל חבילה דחוסה
- 668 B
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
Field.Root
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
id* | string | — | מזהה יציב שכל חלק מעביר בחזרה כ-fieldId, כדי שהתווית, הפקד, התיאור והשגיאה יקושרו זה לזה ב-HTML מהשרת. |
invalid | boolean | false | מסמן את השדה כלא תקין וחושף data-invalid לצורך עיצוב. |
required | boolean | false | מסמן את השדה כנדרש וחושף data-required לצורך עיצוב. |
disabled | boolean | false | מסמן את השדה כמושבת וחושף data-disabled לצורך עיצוב. |
name | string | — | מתקבל לצורך תאימות API; השם שייך לפקד ואינו מוצג על המעטפת. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Field.Label
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
className / style / ref / native label props | native label props | — | המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה. |
fieldId* | string | — | אותו מזהה שניתן ל-Field.Root, שממנו נגזר htmlFor המפנה לפקד. |
disabled | boolean | false | מסמן את התווית כמושבתת וחושף data-disabled לצורך עיצוב. |
required | boolean | false | מסמן את התווית כנדרשת וחושף data-required לצורך עיצוב. |
Field.Control
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
as | ElementType | "div" | ניתן להשתמש ב-input, textarea, select או פקד מותאם אישית. מאפיינים מובנים, מטפלי אירועים, style ו-ref מועברים הלאה. |
type / name / autoComplete / minLength / maxLength / pattern / readOnly | native control props | — | אפשרויות הקלט שייכות ל-Field.Control, לרבות type="password". נשמרת ההתנהגות התקנית של אימות ושל FormData. |
fieldId* | string | — | אותו מזהה שניתן ל-Field.Root, שממנו נגזרים מזהה הפקד והקישורים שלו באמצעות aria-labelledby ו-aria-describedby. |
disabled | boolean | false | מעביר disabled מובנה ל-input, textarea ו-select, וחושף data-disabled. |
invalid | boolean | false | מגדיר aria-invalid ומוסיף את הודעת השגיאה ל-aria-describedby של הפקד. |
required | boolean | false | מעביר required מובנה ל-input, textarea ו-select, ומגדיר aria-required. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Field.Description
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
className / style / ref / native p props | native p props | — | המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה. |
fieldId* | string | — | אותו מזהה שניתן ל-Field.Root, שממנו נגזר מזהה התיאור שהפקד מפנה אליו. |
disabled | boolean | false | מסמן את התיאור כמושבת וחושף data-disabled לצורך עיצוב. |
Field.Error
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
className / style / ref / native p props | native p props | — | המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה. |
fieldId* | string | — | אותו מזהה שניתן ל-Field.Root, שממנו נגזר מזהה השגיאה שהפקד מפנה אליו כשהוא לא תקין. |
invalid | boolean | false | מציג את הודעת השגיאה; החלק אינו מציג דבר כשהערך false. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד אל הפקד או ממנו |
| Enter / Space | הפעלה כשהפקד ממוקד (פקדים דמויי כפתור) |
נגישות
משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.
נקודות חיבור לעיצוב
data-disabled