الاستيراد
import { NuiDropzone, type NuiUploader } from '@needless-ui/angular/dropzone';NuiDropzone
مكان لإفلات الملفات، أو لاختيارها.
| الاسم | النوع | القيمة الافتراضية | الوصف |
|---|---|---|---|
filesثنائي الاتجاه | File[] | [] | الملفات التي تحتفظ بها، بالترتيب. |
acceptمُدخَل | string | أنواع الملفات التي تقبلها، كما في <input type="file">. | |
multipleمُدخَل | boolean | true | أكثر من ملف في المرة الواحدة. |
directoryمُدخَل | boolean | false | يعرض زرًّا لاختيار مجلد. |
maxFilesمُدخَل | number | Infinity | أقصى عدد من الملفات تحتفظ به. |
maxSize, minSizeمُدخَل | number (bytes) | أكبر حجم للملف وأصغره، بالبايت. | |
validateمُدخَل | (file: File) => string | null | يفحص كل ملف، وإذا أعاد رسالة رُفض الملف. | |
uploadمُدخَل | NuiUploader<R> | يُرسل ملفًا. ودونه يُكتفى بالاحتفاظ بالملفات. | |
concurrencyمُدخَل | number | 3 | عدد الملفات التي تُرفع في آنٍ واحد. |
hintمُدخَل | string | سطر توضيحي تحت نص المنطقة، يذكر مثلًا ما تقبله. | |
disabledمُدخَل | boolean | false | لا تقبل أي ملفات. |
labelsمُدخَل | Partial<NuiDropzoneLabels> | كل نص تعرضه أو تُعلنه، لترجمته. | |
uploadedمُخرَج | NuiUpload<R> | يُطلق الملف الذي اكتمل رفعه، مع ما أعاده upload. | |
rejectedمُخرَج | { file, reason }[] | يُطلق الملفات المرفوضة، مع أسباب رفضها. | |
queueخاصية | NuiUploadQueue<R> | قائمة انتظار الرفع، للإلغاء وإعادة المحاولة وقراءة التقدّم من الشيفرة. | |
takeدالة | (files: Iterable<File>) => void | يضيف ملفات من الشيفرة، ويفحص كلًّا منها. |
NuiUploader
يُرسل ملفًا واحدًا: يُبلغ عن التقدّم من 0 إلى 1، ويتوقف حين تُلغى الإشارة (signal).
| الاسم | النوع | القيمة الافتراضية | الوصف |
|---|---|---|---|
(file, context)دالة | (file: File, { signal, progress }) => Promise<R> | يُعيد وعدًا (promise) بما يُجيب به خادمك، أيًّا كان. |