File upload
אזור שחרור קבצים ורשימת קבצים.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 1
- גודל חבילה דחוסה
- 2.27 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
FileUpload.Root
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | חלקי העלאת קבצים: קלט מוסתר, כפתור פתיחה, אזור שחרור ורשימה. |
value | readonly File[] | — | הקבצים הנוכחיים, ההופכים את הרכיב למבוקר. |
defaultValue | readonly File[] | [] | הקבצים ההתחלתיים של הרכיב הלא מבוקר. |
onValueChange | (files: File[]) => void | — | נקראת עם הקבצים שהתקבלו בכל שינוי בבחירה. |
onReject | (rejections: FileRejection[]) => void | — | נקראת עם הקבצים שנכשלו באימות והסיבות לכך. |
accept | string[] | [] | סוגי הקבצים המותרים, כסיומות או כסוגי MIME. |
maxFiles | number | — | המספר המרבי של קבצים שניתן להחזיק בו-זמנית. |
maxSize | number | — | גודל הקובץ המרבי המותר בבתים. |
minSize | number | — | גודל הקובץ המזערי המותר בבתים. |
multiple | boolean | false | מאפשר לבורר לבחור יותר מקובץ אחד. |
disabled | boolean | false | משבית את הבורר, אזור השחרור וכפתורי ההסרה. |
FileUpload.HiddenInput
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
className | string | — | המחלקה המוחלת על קלט הקובץ המובנה. |
FileUpload.Trigger
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | תוכן הפקד שפותח את בורר הקבצים. |
className | string | — | המחלקה המוחלת על אלמנט הפתיחה. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
FileUpload.Dropzone
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | תוכן יעד השחרור. |
className | string | — | המחלקה המוחלת על אלמנט אזור השחרור. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
FileUpload.List
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | ((files: readonly File[]) => ReactNode) | — | מציג קבצים שהתקבלו מתוך הרשימה החיה. שינויים בערך המבוקר ואיפוסים חיצוניים משתקפים מיד. |
className | string | — | המחלקה המוחלת על אלמנט הרשימה. |
FileUpload.Item
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | תוכן המתאר את הקובץ, כגון שמו וגודלו. |
className | string | — | המחלקה המוחלת על אלמנט הפריט. |
index* | number | — | מיקום הקובץ שפריט זה מייצג. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
FileUpload.ItemRemove
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
className | string | — | המחלקה המוחלת על כפתור ההסרה. |
index* | number | — | מיקום הקובץ שכפתור זה מסיר. |
FileRejection
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
file* | File | — | הקובץ שלא התקבל. |
reason* | "accept" | "max-size" | "max-files" | — | הכלל שהקובץ לא עמד בו. |
מקלדת
| מקש | פעולה |
|---|---|
| Enter / Space | פתיחת בורר הקבצים מתוך Trigger או הסרת קובץ ממוקד |
| Tab | מעבר בין מפעיל הבורר לבין פקדי הסרת הקבצים |
נגישות
תנו ל-HiddenInput תווית נגישה. List מקבל את הקבצים שהתקבלו ומרנדר את שמותיהם, גודלם וכפתורי הסרה עם תוויות. Root תומך ב-value מבוקר, ב-maxFiles מצטבר ובאימות maxSize ו-accept; onReject מדווח על קבצים שנדחו. שורשים מושבתים חוסמים פעולות בחירה, שחרור והסרה. הטיפול בקבצים דורש הידרציה.
נקודות חיבור לעיצוב
data-uiify-file-uploaddata-partdata-disableddata-state