انتقل إلى المحتوى
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 قيمة متحكّمًا بها والتحقق التراكمي من maxFiles وmaxSize وaccept؛ ويبلّغ onReject عن الملفات المرفوضة. تمنع الجذور المعطّلة إجراءات المنتقي والإسقاط والإزالة. تتطلب معالجة الملفات الإماهة.

    نقاط التنسيق

    data-uiify-file-uploaddata-partdata-disableddata-state