דילוג לתוכן
uiify

File upload

אזור שחרור קבצים ורשימת קבצים.

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

מגרש ניסויים

File upload

Attachments

Drop files here, or choose files above.

    Up to 3 files · 5 MB each

    שחרור קבצים כאן

    API

    FileUpload.Root

    מאפייןטיפוסברירת מחדלתיאור
    childrenReactNode—חלקי העלאת קבצים: קלט מוסתר, כפתור פתיחה, אזור שחרור ורשימה.
    valuereadonly File[]—הקבצים הנוכחיים, ההופכים את הרכיב למבוקר.
    defaultValuereadonly File[][]הקבצים ההתחלתיים של הרכיב הלא מבוקר.
    onValueChange(files: File[]) => void—נקראת עם הקבצים שהתקבלו בכל שינוי בבחירה.
    onReject(rejections: FileRejection[]) => void—נקראת עם הקבצים שנכשלו באימות והסיבות לכך.
    acceptstring[][]סוגי הקבצים המותרים, כסיומות או כסוגי MIME.
    maxFilesnumber—המספר המרבי של קבצים שניתן להחזיק בו-זמנית.
    maxSizenumber—גודל הקובץ המרבי המותר בבתים.
    minSizenumber—גודל הקובץ המזערי המותר בבתים.
    multiplebooleanfalseמאפשר לבורר לבחור יותר מקובץ אחד.
    disabledbooleanfalseמשבית את הבורר, אזור השחרור וכפתורי ההסרה.

    FileUpload.HiddenInput

    מאפייןטיפוסברירת מחדלתיאור
    classNamestring—המחלקה המוחלת על קלט הקובץ המובנה.

    FileUpload.Trigger

    מאפייןטיפוסברירת מחדלתיאור
    childrenReactNode—תוכן הפקד שפותח את בורר הקבצים.
    classNamestring—המחלקה המוחלת על אלמנט הפתיחה.
    renderReactElement | ((props, state) => ReactElement)—החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות.

    FileUpload.Dropzone

    מאפייןטיפוסברירת מחדלתיאור
    childrenReactNode—תוכן יעד השחרור.
    classNamestring—המחלקה המוחלת על אלמנט אזור השחרור.
    renderReactElement | ((props, state) => ReactElement)—החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות.

    FileUpload.List

    מאפייןטיפוסברירת מחדלתיאור
    childrenReactNode | ((files: readonly File[]) => ReactNode)—מציג קבצים שהתקבלו מתוך הרשימה החיה. שינויים בערך המבוקר ואיפוסים חיצוניים משתקפים מיד.
    classNamestring—המחלקה המוחלת על אלמנט הרשימה.

    FileUpload.Item

    מאפייןטיפוסברירת מחדלתיאור
    childrenReactNode—תוכן המתאר את הקובץ, כגון שמו וגודלו.
    classNamestring—המחלקה המוחלת על אלמנט הפריט.
    index*number—מיקום הקובץ שפריט זה מייצג.
    renderReactElement | ((props, state) => ReactElement)—החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות.

    FileUpload.ItemRemove

    מאפייןטיפוסברירת מחדלתיאור
    classNamestring—המחלקה המוחלת על כפתור ההסרה.
    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
    דף זה תורגם אוטומטית וטרם נבדק.