דילוג לתוכן
uiify

Field

מעטפת לתווית, לפקד ולהודעת שגיאה.

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

מגרש ניסויים

Field

ברירת מחדל

Your display name

Invalid

Password

Use at least eight characters.

Message

Up to 500 characters.

מושבת

Read only

API

Field.Root

מאפייןטיפוסברירת מחדלתיאור
id*string—מזהה יציב שכל חלק מעביר בחזרה כ-fieldId, כדי שהתווית, הפקד, התיאור והשגיאה יקושרו זה לזה ב-HTML מהשרת.
invalidbooleanfalseמסמן את השדה כלא תקין וחושף data-invalid לצורך עיצוב.
requiredbooleanfalseמסמן את השדה כנדרש וחושף data-required לצורך עיצוב.
disabledbooleanfalseמסמן את השדה כמושבת וחושף data-disabled לצורך עיצוב.
namestring—מתקבל לצורך תאימות API; השם שייך לפקד ואינו מוצג על המעטפת.
renderReactElement | ((props, state) => ReactElement)—החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות.

Field.Label

מאפייןטיפוסברירת מחדלתיאור
className / style / ref / native label propsnative label props—המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה.
fieldId*string—אותו מזהה שניתן ל-Field.Root, שממנו נגזר htmlFor המפנה לפקד.
disabledbooleanfalseמסמן את התווית כמושבתת וחושף data-disabled לצורך עיצוב.
requiredbooleanfalseמסמן את התווית כנדרשת וחושף data-required לצורך עיצוב.

Field.Control

מאפייןטיפוסברירת מחדלתיאור
asElementType"div"ניתן להשתמש ב-input, textarea, select או פקד מותאם אישית. מאפיינים מובנים, מטפלי אירועים, style ו-ref מועברים הלאה.
type / name / autoComplete / minLength / maxLength / pattern / readOnlynative control props—אפשרויות הקלט שייכות ל-Field.Control, לרבות type="password". נשמרת ההתנהגות התקנית של אימות ושל FormData.
fieldId*string—אותו מזהה שניתן ל-Field.Root, שממנו נגזרים מזהה הפקד והקישורים שלו באמצעות aria-labelledby ו-aria-describedby.
disabledbooleanfalseמעביר disabled מובנה ל-input, textarea ו-select, וחושף data-disabled.
invalidbooleanfalseמגדיר aria-invalid ומוסיף את הודעת השגיאה ל-aria-describedby של הפקד.
requiredbooleanfalseמעביר required מובנה ל-input, textarea ו-select, ומגדיר aria-required.
renderReactElement | ((props, state) => ReactElement)—החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות.

Field.Description

מאפייןטיפוסברירת מחדלתיאור
className / style / ref / native p propsnative p props—המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה.
fieldId*string—אותו מזהה שניתן ל-Field.Root, שממנו נגזר מזהה התיאור שהפקד מפנה אליו.
disabledbooleanfalseמסמן את התיאור כמושבת וחושף data-disabled לצורך עיצוב.

Field.Error

מאפייןטיפוסברירת מחדלתיאור
className / style / ref / native p propsnative p props—המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה.
fieldId*string—אותו מזהה שניתן ל-Field.Root, שממנו נגזר מזהה השגיאה שהפקד מפנה אליו כשהוא לא תקין.
invalidbooleanfalseמציג את הודעת השגיאה; החלק אינו מציג דבר כשהערך false.

מקלדת

מקשפעולה
Tabהעברת המיקוד אל הפקד או ממנו
Enter / Spaceהפעלה כשהפקד ממוקד (פקדים דמויי כפתור)

נגישות

משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.

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

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