@cloud-ru/ds-uikit-product-upload-files 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/LICENSE +201 -0
- package/README.md +238 -0
- package/dist/cjs/UploadFiles.d.ts +20 -0
- package/dist/cjs/UploadFiles.js +93 -0
- package/dist/cjs/components/Attachments/Attachments.d.ts +10 -0
- package/dist/cjs/components/Attachments/Attachments.js +18 -0
- package/dist/cjs/components/Attachments/index.d.ts +2 -0
- package/dist/cjs/components/Attachments/index.js +5 -0
- package/dist/cjs/components/UploadFilesDropZone/UploadFilesDropZone.d.ts +2 -0
- package/dist/cjs/components/UploadFilesDropZone/UploadFilesDropZone.js +14 -0
- package/dist/cjs/components/UploadFilesDropZone/index.d.ts +1 -0
- package/dist/cjs/components/UploadFilesDropZone/index.js +5 -0
- package/dist/cjs/components/index.d.ts +2 -0
- package/dist/cjs/components/index.js +18 -0
- package/dist/cjs/constants.d.ts +18 -0
- package/dist/cjs/constants.js +22 -0
- package/dist/cjs/hooks/index.d.ts +2 -0
- package/dist/cjs/hooks/index.js +5 -0
- package/dist/cjs/hooks/useUploadFilesController.d.ts +30 -0
- package/dist/cjs/hooks/useUploadFilesController.js +116 -0
- package/dist/cjs/index.d.ts +8 -0
- package/dist/cjs/index.js +31 -0
- package/dist/cjs/locale/index.d.ts +87 -0
- package/dist/cjs/locale/index.js +48 -0
- package/dist/cjs/package.json +3 -0
- package/dist/cjs/style.css +42 -0
- package/dist/cjs/styles.module.css +42 -0
- package/dist/cjs/types.d.ts +72 -0
- package/dist/cjs/types.js +2 -0
- package/dist/cjs/utils.d.ts +15 -0
- package/dist/cjs/utils.js +67 -0
- package/dist/esm/UploadFiles.d.ts +20 -0
- package/dist/esm/UploadFiles.js +87 -0
- package/dist/esm/components/Attachments/Attachments.d.ts +10 -0
- package/dist/esm/components/Attachments/Attachments.js +12 -0
- package/dist/esm/components/Attachments/index.d.ts +2 -0
- package/dist/esm/components/Attachments/index.js +1 -0
- package/dist/esm/components/UploadFilesDropZone/UploadFilesDropZone.d.ts +2 -0
- package/dist/esm/components/UploadFilesDropZone/UploadFilesDropZone.js +8 -0
- package/dist/esm/components/UploadFilesDropZone/index.d.ts +1 -0
- package/dist/esm/components/UploadFilesDropZone/index.js +1 -0
- package/dist/esm/components/index.d.ts +2 -0
- package/dist/esm/components/index.js +2 -0
- package/dist/esm/constants.d.ts +18 -0
- package/dist/esm/constants.js +19 -0
- package/dist/esm/hooks/index.d.ts +2 -0
- package/dist/esm/hooks/index.js +1 -0
- package/dist/esm/hooks/useUploadFilesController.d.ts +30 -0
- package/dist/esm/hooks/useUploadFilesController.js +113 -0
- package/dist/esm/index.d.ts +8 -0
- package/dist/esm/index.js +7 -0
- package/dist/esm/locale/index.d.ts +87 -0
- package/dist/esm/locale/index.js +45 -0
- package/dist/esm/style.css +42 -0
- package/dist/esm/styles.module.css +42 -0
- package/dist/esm/types.d.ts +72 -0
- package/dist/esm/types.js +1 -0
- package/dist/esm/utils.d.ts +15 -0
- package/dist/esm/utils.js +60 -0
- package/dist/tsconfig.cjs.tsbuildinfo +1 -0
- package/dist/tsconfig.esm.tsbuildinfo +1 -0
- package/package.json +56 -0
- package/src/UploadFiles.tsx +212 -0
- package/src/components/Attachments/Attachments.tsx +44 -0
- package/src/components/Attachments/index.ts +2 -0
- package/src/components/UploadFilesDropZone/UploadFilesDropZone.tsx +27 -0
- package/src/components/UploadFilesDropZone/index.ts +1 -0
- package/src/components/index.ts +2 -0
- package/src/constants.ts +27 -0
- package/src/hooks/index.ts +7 -0
- package/src/hooks/useUploadFilesController.ts +199 -0
- package/src/index.ts +14 -0
- package/src/locale/index.ts +49 -0
- package/src/styles.module.scss +52 -0
- package/src/types.ts +78 -0
- package/src/utils.ts +84 -0
package/src/constants.ts
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { UploadFilesAcceptItem } from './types';
|
|
2
|
+
|
|
3
|
+
export const UPLOAD_STATUS = {
|
|
4
|
+
Uploading: 'uploading',
|
|
5
|
+
Success: 'success',
|
|
6
|
+
Error: 'error',
|
|
7
|
+
} as const;
|
|
8
|
+
|
|
9
|
+
export const SUMMARY_ERROR_TYPE = {
|
|
10
|
+
FileLimit: 'fileLimit',
|
|
11
|
+
SomeFilesNotUploaded: 'someFilesNotUploaded',
|
|
12
|
+
} as const;
|
|
13
|
+
|
|
14
|
+
export const DEFAULT_MAX_FILES = 3;
|
|
15
|
+
export const DEFAULT_MAX_SIZE = 5 * 1024 * 1024;
|
|
16
|
+
|
|
17
|
+
// `*` — любой файл по умолчанию: без иконок и отображаемых имён форматов.
|
|
18
|
+
export const DEFAULT_ACCEPT: UploadFilesAcceptItem[] = [{ extention: '*' }];
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
const PREFIX = 'upload-files';
|
|
22
|
+
|
|
23
|
+
export const TEST_IDS = {
|
|
24
|
+
root: PREFIX,
|
|
25
|
+
dropzone: `${PREFIX}__dropzone`,
|
|
26
|
+
attachment: `${PREFIX}__attachment`,
|
|
27
|
+
} as const;
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { FILE_REJECTION_REASON, FileRejection, partitionFiles } from '@cloud-ru/ds-dropzone';
|
|
2
|
+
import { useCallback, useEffect, useRef } from 'react';
|
|
3
|
+
|
|
4
|
+
import { SUMMARY_ERROR_TYPE, UPLOAD_STATUS } from '../constants';
|
|
5
|
+
import { UploadFileItem, UploadFn } from '../types';
|
|
6
|
+
import { makeId } from '../utils';
|
|
7
|
+
|
|
8
|
+
export type SummaryErrorType = (typeof SUMMARY_ERROR_TYPE)[keyof typeof SUMMARY_ERROR_TYPE] | null;
|
|
9
|
+
|
|
10
|
+
/** Готовые локализованные тексты ошибок для контроллера */
|
|
11
|
+
export type UploadFilesMessages = {
|
|
12
|
+
fileFormatError: string;
|
|
13
|
+
fileSizeError: string;
|
|
14
|
+
fileLimitError: string;
|
|
15
|
+
uploadError: string;
|
|
16
|
+
};
|
|
17
|
+
|
|
18
|
+
export type UseUploadFilesControllerOptions<TResult> = {
|
|
19
|
+
value: UploadFileItem<TResult>[];
|
|
20
|
+
onChange: (items: UploadFileItem<TResult>[]) => void;
|
|
21
|
+
upload: UploadFn<TResult>;
|
|
22
|
+
accept?: string;
|
|
23
|
+
maxFiles?: number;
|
|
24
|
+
maxSize?: number;
|
|
25
|
+
disabled?: boolean;
|
|
26
|
+
messages: UploadFilesMessages;
|
|
27
|
+
};
|
|
28
|
+
|
|
29
|
+
export type UseUploadFilesControllerResult<TResult> = {
|
|
30
|
+
items: UploadFileItem<TResult>[];
|
|
31
|
+
summaryError: string | undefined;
|
|
32
|
+
summaryErrorType: SummaryErrorType;
|
|
33
|
+
handleFilesUpload: (files: File[]) => void;
|
|
34
|
+
handleFilesReject: (rejections: FileRejection[]) => void;
|
|
35
|
+
handleDelete: (id: string) => void;
|
|
36
|
+
};
|
|
37
|
+
|
|
38
|
+
export function useUploadFilesController<TResult>({
|
|
39
|
+
value,
|
|
40
|
+
onChange,
|
|
41
|
+
upload,
|
|
42
|
+
accept,
|
|
43
|
+
maxFiles,
|
|
44
|
+
maxSize,
|
|
45
|
+
disabled,
|
|
46
|
+
messages,
|
|
47
|
+
}: UseUploadFilesControllerOptions<TResult>): UseUploadFilesControllerResult<TResult> {
|
|
48
|
+
const abortControllersRef = useRef<Map<string, AbortController>>(new Map());
|
|
49
|
+
|
|
50
|
+
const valueRef = useRef(value);
|
|
51
|
+
valueRef.current = value;
|
|
52
|
+
|
|
53
|
+
const onChangeRef = useRef(onChange);
|
|
54
|
+
onChangeRef.current = onChange;
|
|
55
|
+
|
|
56
|
+
const uploadRef = useRef(upload);
|
|
57
|
+
uploadRef.current = upload;
|
|
58
|
+
|
|
59
|
+
useEffect(() => {
|
|
60
|
+
const controllers = abortControllersRef.current;
|
|
61
|
+
|
|
62
|
+
return () => {
|
|
63
|
+
controllers.forEach(controller => controller.abort());
|
|
64
|
+
controllers.clear();
|
|
65
|
+
};
|
|
66
|
+
}, []);
|
|
67
|
+
|
|
68
|
+
const updateItems = useCallback((updater: (prev: UploadFileItem<TResult>[]) => UploadFileItem<TResult>[]) => {
|
|
69
|
+
// Синхронно обновляем ref, чтобы параллельные загрузки, завершившиеся до
|
|
70
|
+
// следующего ре-рендера, строили обновление на актуальном состоянии, а не
|
|
71
|
+
// на устаревшем value — иначе последний onChange затирает остальные.
|
|
72
|
+
const next = updater(valueRef.current);
|
|
73
|
+
valueRef.current = next;
|
|
74
|
+
onChangeRef.current(next);
|
|
75
|
+
}, []);
|
|
76
|
+
|
|
77
|
+
const startUpload = useCallback(
|
|
78
|
+
(item: UploadFileItem<TResult>) => {
|
|
79
|
+
const controller = new AbortController();
|
|
80
|
+
abortControllersRef.current.set(item.id, controller);
|
|
81
|
+
|
|
82
|
+
uploadRef
|
|
83
|
+
.current(item.file, { signal: controller.signal })
|
|
84
|
+
.then(result => {
|
|
85
|
+
abortControllersRef.current.delete(item.id);
|
|
86
|
+
updateItems(prev =>
|
|
87
|
+
prev.map(current =>
|
|
88
|
+
current.id === item.id
|
|
89
|
+
? { ...current, status: UPLOAD_STATUS.Success, result, progress: 100, error: undefined }
|
|
90
|
+
: current,
|
|
91
|
+
),
|
|
92
|
+
);
|
|
93
|
+
})
|
|
94
|
+
.catch(() => {
|
|
95
|
+
abortControllersRef.current.delete(item.id);
|
|
96
|
+
|
|
97
|
+
if (controller.signal.aborted) {
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
updateItems(prev =>
|
|
102
|
+
prev.map(current =>
|
|
103
|
+
current.id === item.id
|
|
104
|
+
? { ...current, status: UPLOAD_STATUS.Error, error: messages.uploadError }
|
|
105
|
+
: current,
|
|
106
|
+
),
|
|
107
|
+
);
|
|
108
|
+
});
|
|
109
|
+
},
|
|
110
|
+
[messages, updateItems],
|
|
111
|
+
);
|
|
112
|
+
|
|
113
|
+
const handleFilesUpload = useCallback(
|
|
114
|
+
(files: File[]) => {
|
|
115
|
+
if (disabled || !files.length) {
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
const { accepted, rejected } = partitionFiles(files, { accept, maxSize });
|
|
120
|
+
|
|
121
|
+
const rejectedItems: UploadFileItem<TResult>[] = rejected.map(({ file, reason }) => ({
|
|
122
|
+
id: makeId(),
|
|
123
|
+
file,
|
|
124
|
+
status: UPLOAD_STATUS.Error,
|
|
125
|
+
error: reason === FILE_REJECTION_REASON.MaxSize ? messages.fileSizeError : messages.fileFormatError,
|
|
126
|
+
}));
|
|
127
|
+
|
|
128
|
+
const acceptedItems: UploadFileItem<TResult>[] = accepted.map(file => ({
|
|
129
|
+
id: makeId(),
|
|
130
|
+
file,
|
|
131
|
+
status: UPLOAD_STATUS.Uploading,
|
|
132
|
+
}));
|
|
133
|
+
|
|
134
|
+
const next = [...valueRef.current, ...rejectedItems, ...acceptedItems];
|
|
135
|
+
valueRef.current = next;
|
|
136
|
+
onChangeRef.current(next);
|
|
137
|
+
|
|
138
|
+
acceptedItems.forEach(startUpload);
|
|
139
|
+
},
|
|
140
|
+
[accept, disabled, maxSize, messages, startUpload],
|
|
141
|
+
);
|
|
142
|
+
|
|
143
|
+
// Отклонённые валидацией файлы (формат/размер) показываем в списке как error-вложения. Причина
|
|
144
|
+
// из `FileRejection` определяет текст: превышение размера vs недопустимый формат. Файлы не грузятся.
|
|
145
|
+
const handleFilesReject = useCallback(
|
|
146
|
+
(rejections: FileRejection[]) => {
|
|
147
|
+
if (disabled || !rejections.length) {
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
const rejectedItems: UploadFileItem<TResult>[] = rejections.map(({ file, reason }) => ({
|
|
152
|
+
id: makeId(),
|
|
153
|
+
file,
|
|
154
|
+
status: UPLOAD_STATUS.Error,
|
|
155
|
+
error: reason === FILE_REJECTION_REASON.MaxSize ? messages.fileSizeError : messages.fileFormatError,
|
|
156
|
+
}));
|
|
157
|
+
|
|
158
|
+
const next = [...valueRef.current, ...rejectedItems];
|
|
159
|
+
valueRef.current = next;
|
|
160
|
+
onChangeRef.current(next);
|
|
161
|
+
},
|
|
162
|
+
[disabled, messages],
|
|
163
|
+
);
|
|
164
|
+
|
|
165
|
+
const handleDelete = useCallback(
|
|
166
|
+
(id: string) => {
|
|
167
|
+
const controller = abortControllersRef.current.get(id);
|
|
168
|
+
|
|
169
|
+
if (controller) {
|
|
170
|
+
controller.abort();
|
|
171
|
+
abortControllersRef.current.delete(id);
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
updateItems(prev => prev.filter(item => item.id !== id));
|
|
175
|
+
},
|
|
176
|
+
[updateItems],
|
|
177
|
+
);
|
|
178
|
+
|
|
179
|
+
const hasItemErrors = value.some(item => item.status === UPLOAD_STATUS.Error || Boolean(item.error));
|
|
180
|
+
const isOverLimit = typeof maxFiles === 'number' && value.length > maxFiles;
|
|
181
|
+
|
|
182
|
+
let summaryError: string | undefined;
|
|
183
|
+
let summaryErrorType: SummaryErrorType = null;
|
|
184
|
+
if (isOverLimit) {
|
|
185
|
+
summaryError = messages.fileLimitError;
|
|
186
|
+
summaryErrorType = SUMMARY_ERROR_TYPE.FileLimit;
|
|
187
|
+
} else if (hasItemErrors) {
|
|
188
|
+
summaryErrorType = SUMMARY_ERROR_TYPE.SomeFilesNotUploaded;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
return {
|
|
192
|
+
items: value,
|
|
193
|
+
summaryError,
|
|
194
|
+
summaryErrorType,
|
|
195
|
+
handleFilesUpload,
|
|
196
|
+
handleFilesReject,
|
|
197
|
+
handleDelete,
|
|
198
|
+
};
|
|
199
|
+
}
|
package/src/index.ts
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export { buildAcceptAttribute } from '@cloud-ru/ds-dropzone';
|
|
2
|
+
|
|
3
|
+
export { UploadFiles } from './UploadFiles';
|
|
4
|
+
export * from './constants';
|
|
5
|
+
export * from './types';
|
|
6
|
+
export { formatFileSize, formatFileDescription, joinWithConjunction, makeId } from './utils';
|
|
7
|
+
export { useUploadFilesController } from './hooks';
|
|
8
|
+
export type {
|
|
9
|
+
SummaryErrorType,
|
|
10
|
+
UploadFilesMessages,
|
|
11
|
+
UseUploadFilesControllerOptions,
|
|
12
|
+
UseUploadFilesControllerResult,
|
|
13
|
+
} from './hooks';
|
|
14
|
+
export * from './locale';
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { defineLocale, defineMessages } from '@cloud-ru/ds-locale';
|
|
2
|
+
|
|
3
|
+
const UPLOAD_FILES_MESSAGES = defineMessages({
|
|
4
|
+
'en-GB': {
|
|
5
|
+
optional: 'Optional',
|
|
6
|
+
dropzoneTitle: 'Drag a file here or click',
|
|
7
|
+
dropzoneButton: 'Select file',
|
|
8
|
+
dropzoneDescription: '{{formats}} no more than {{count}} files up to {{size}}',
|
|
9
|
+
dropzoneDescriptionNoFormats: 'No more than {{count}} files up to {{size}}',
|
|
10
|
+
errorRequired: 'Required field',
|
|
11
|
+
errorSomeFilesNotUploaded: 'Some files were not uploaded',
|
|
12
|
+
errorFileLimit: 'You can upload no more than {{count}} files',
|
|
13
|
+
errorFileFormat: 'Only {{formats}} are supported',
|
|
14
|
+
errorFileSize: 'File size must not exceed {{size}}',
|
|
15
|
+
formatsConjunction: 'and',
|
|
16
|
+
uploadError: 'Upload failed',
|
|
17
|
+
units: {
|
|
18
|
+
b: 'B',
|
|
19
|
+
kb: 'KB',
|
|
20
|
+
mb: 'MB',
|
|
21
|
+
gb: 'GB',
|
|
22
|
+
},
|
|
23
|
+
},
|
|
24
|
+
'ru-RU': {
|
|
25
|
+
optional: 'Опционально',
|
|
26
|
+
dropzoneTitle: 'Перетащите файл или нажмите',
|
|
27
|
+
dropzoneButton: 'Выбрать файл',
|
|
28
|
+
dropzoneDescription: '{{formats}} не более {{count}} файлов до {{size}}',
|
|
29
|
+
dropzoneDescriptionNoFormats: 'Не более {{count}} файлов до {{size}}',
|
|
30
|
+
errorRequired: 'Обязательное поле',
|
|
31
|
+
errorSomeFilesNotUploaded: 'Некоторые файлы не загружены',
|
|
32
|
+
errorFileLimit: 'Можно загрузить не более {{count}} файлов',
|
|
33
|
+
errorFileFormat: 'Поддерживаются только {{formats}}',
|
|
34
|
+
errorFileSize: 'Размер файла превышает {{size}}',
|
|
35
|
+
formatsConjunction: 'и',
|
|
36
|
+
uploadError: 'Ошибка загрузки',
|
|
37
|
+
units: {
|
|
38
|
+
b: 'Б',
|
|
39
|
+
kb: 'Кб',
|
|
40
|
+
mb: 'Мб',
|
|
41
|
+
gb: 'Гб',
|
|
42
|
+
},
|
|
43
|
+
},
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
export type UploadFilesMessages = (typeof UPLOAD_FILES_MESSAGES)['en-GB'];
|
|
47
|
+
|
|
48
|
+
/** locale компонента UploadFiles: `uploadFilesLocale.useTranslations()` в коде, `.extend(...)` в сервисе. */
|
|
49
|
+
export const uploadFilesLocale = defineLocale('@cloud-ru/ds-uikit-product-upload-files', UPLOAD_FILES_MESSAGES);
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
@use '@cloud-ru/ds-figma-variables/build/scss/styles/styles.module' as base;
|
|
2
|
+
|
|
3
|
+
.root {
|
|
4
|
+
display: flex;
|
|
5
|
+
flex-direction: column;
|
|
6
|
+
gap: base.$sn-density-spacing-interval-s;
|
|
7
|
+
width: 100%;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
.dropzoneSection {
|
|
11
|
+
width: 100%;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
.dropzoneContent {
|
|
15
|
+
display: flex;
|
|
16
|
+
flex-direction: column;
|
|
17
|
+
gap: base.$sn-density-spacing-interval-s;
|
|
18
|
+
align-items: center;
|
|
19
|
+
justify-content: center;
|
|
20
|
+
|
|
21
|
+
width: 100%;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
.attachments {
|
|
25
|
+
display: flex;
|
|
26
|
+
flex-direction: column;
|
|
27
|
+
gap: base.$sn-density-spacing-interval-xs;
|
|
28
|
+
width: 100%;
|
|
29
|
+
|
|
30
|
+
// Увеличиваем с 16 до 24. Селектор намеренно специфичнее
|
|
31
|
+
// правила с !important из @cloud-ru/ds-icon-predefined.
|
|
32
|
+
[data-test-id='attachment__icon'] svg[data-size][data-appearance] {
|
|
33
|
+
width: base.$sn-density-size-icon-s !important;
|
|
34
|
+
height: base.$sn-density-size-icon-s !important;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
// Обёртка для role="listitem": display:contents не создаёт бокс,
|
|
39
|
+
// поэтому вложение остаётся прямым flex-элементом списка и раскладка не меняется.
|
|
40
|
+
.attachmentItem {
|
|
41
|
+
display: contents;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
.attachment {
|
|
45
|
+
&[data-acrylic-appearance] {
|
|
46
|
+
width: 100%;
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
.dropzoneDescription {
|
|
51
|
+
color: base.$sn-theme-color-available-version-textTertiary;
|
|
52
|
+
}
|
package/src/types.ts
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { IconPredefinedProps } from '@cloud-ru/ds-icon-predefined';
|
|
2
|
+
import { ValueOf, WithSupportProps } from '@cloud-ru/ds-utils';
|
|
3
|
+
import { FocusEventHandler, ReactNode } from 'react';
|
|
4
|
+
|
|
5
|
+
import { UPLOAD_STATUS } from './constants';
|
|
6
|
+
|
|
7
|
+
export type UploadStatus = ValueOf<typeof UPLOAD_STATUS>;
|
|
8
|
+
|
|
9
|
+
/** Локализованные единицы измерения размера файла */
|
|
10
|
+
export type FileSizeUnits = {
|
|
11
|
+
b: string;
|
|
12
|
+
kb: string;
|
|
13
|
+
mb: string;
|
|
14
|
+
gb: string;
|
|
15
|
+
};
|
|
16
|
+
|
|
17
|
+
export type UploadFileItem<TResult = unknown> = {
|
|
18
|
+
id: string;
|
|
19
|
+
file: File;
|
|
20
|
+
status: UploadStatus;
|
|
21
|
+
progress?: number;
|
|
22
|
+
error?: string;
|
|
23
|
+
result?: TResult;
|
|
24
|
+
};
|
|
25
|
+
|
|
26
|
+
export type UploadFn<TResult = unknown> = (file: File, ctx: { signal: AbortSignal }) => Promise<TResult>;
|
|
27
|
+
|
|
28
|
+
export type UploadFilesAcceptItem = {
|
|
29
|
+
/** Расширение файла (например `.pdf` или `*` для всех типов файлов) */
|
|
30
|
+
extention: string;
|
|
31
|
+
/** Иконка, отображаемая для файлов этого типа во вложениях */
|
|
32
|
+
icon?: IconPredefinedProps['icon'];
|
|
33
|
+
/** Отображаемое расширение файла для пользователя (например `PDF`) */
|
|
34
|
+
displayExtension?: string;
|
|
35
|
+
};
|
|
36
|
+
|
|
37
|
+
export type UploadFilesProps<TResult = unknown> = WithSupportProps<{
|
|
38
|
+
/** Текст метки поля */
|
|
39
|
+
label?: string;
|
|
40
|
+
/** Подсказка question tooltip у метки */
|
|
41
|
+
hint?: ReactNode;
|
|
42
|
+
/**
|
|
43
|
+
* Показывает «Опционально» справа от метки
|
|
44
|
+
* @default true
|
|
45
|
+
*/
|
|
46
|
+
optional?: boolean;
|
|
47
|
+
/** Заблокировано */
|
|
48
|
+
disabled?: boolean;
|
|
49
|
+
/** Контролируемое значение */
|
|
50
|
+
value?: UploadFileItem<TResult>[];
|
|
51
|
+
/** Начальное значение */
|
|
52
|
+
defaultValue?: UploadFileItem<TResult>[];
|
|
53
|
+
/** Колбэк изменения значения */
|
|
54
|
+
onChange?(items: UploadFileItem<TResult>[]): void;
|
|
55
|
+
/** Имя поля формы */
|
|
56
|
+
name?: string;
|
|
57
|
+
onBlur?: FocusEventHandler<HTMLDivElement>;
|
|
58
|
+
/** Ошибка формы (например required из RHF) */
|
|
59
|
+
error?: string;
|
|
60
|
+
/** Обязательная кастомная функция загрузки */
|
|
61
|
+
upload: UploadFn<TResult>;
|
|
62
|
+
/** CSS-класс корня */
|
|
63
|
+
className?: string;
|
|
64
|
+
/** Допустимые типы файлов с иконкой для каждого расширения */
|
|
65
|
+
accept?: UploadFilesAcceptItem[];
|
|
66
|
+
/** Максимальное количество файлов */
|
|
67
|
+
maxFiles?: number;
|
|
68
|
+
/** Максимальный размер файла в байтах */
|
|
69
|
+
maxSize?: number;
|
|
70
|
+
/** CSS-класс прикрепленного файла */
|
|
71
|
+
attachmentClassname?: string;
|
|
72
|
+
}>;
|
|
73
|
+
|
|
74
|
+
export type UploadFilesDropZoneProps = {
|
|
75
|
+
title?: string;
|
|
76
|
+
description?: ReactNode;
|
|
77
|
+
buttonLabel?: string;
|
|
78
|
+
};
|
package/src/utils.ts
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { FileSizeUnits, UploadFilesAcceptItem } from './types';
|
|
2
|
+
|
|
3
|
+
function getFileExtension(fileName?: string) {
|
|
4
|
+
return fileName?.split('.').pop()?.toUpperCase();
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Подбирает иконку для файла по его расширению из списка accept.
|
|
9
|
+
* Возвращает undefined, если расширение не описано — тогда Attachment
|
|
10
|
+
* использует свою дефолтную иконку.
|
|
11
|
+
*/
|
|
12
|
+
export function resolveFileIcon(
|
|
13
|
+
file: File,
|
|
14
|
+
accept: UploadFilesAcceptItem[],
|
|
15
|
+
): UploadFilesAcceptItem['icon'] | undefined {
|
|
16
|
+
const extension = getFileExtension(file.name);
|
|
17
|
+
|
|
18
|
+
if (!extension) {
|
|
19
|
+
return undefined;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
const match = accept.find(item => item.extention.replace(/^\./, '').toUpperCase() === extension);
|
|
23
|
+
|
|
24
|
+
return match?.icon;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export function makeId(): string {
|
|
28
|
+
if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
|
|
29
|
+
return `upload-file-${crypto.randomUUID()}`;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
return `upload-file-${Date.now()}-${Math.random().toString(36).slice(2)}`;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Объединяет значения в перечисление: разделитель «, » между элементами,
|
|
37
|
+
* а последние два соединяются союзом (`PDF, TXT и DOCX`).
|
|
38
|
+
*/
|
|
39
|
+
export function joinWithConjunction(parts: string[], conjunction: string): string {
|
|
40
|
+
if (parts.length <= 1) {
|
|
41
|
+
return parts.join('');
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
const head = parts.slice(0, -1).join(', ');
|
|
45
|
+
const last = parts[parts.length - 1];
|
|
46
|
+
|
|
47
|
+
return `${head} ${conjunction} ${last}`;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export function formatFileSize(bytes: number, units: FileSizeUnits): string {
|
|
51
|
+
if (bytes < 1024) {
|
|
52
|
+
return `${bytes} ${units.b}`;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
if (bytes < 1024 * 1024) {
|
|
56
|
+
const kb = bytes / 1024;
|
|
57
|
+
const rounded = kb >= 10 ? Math.round(kb) : Math.round(kb * 10) / 10;
|
|
58
|
+
|
|
59
|
+
return `${rounded} ${units.kb}`;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
if (bytes < 1024 * 1024 * 1024) {
|
|
63
|
+
const mb = bytes / (1024 * 1024);
|
|
64
|
+
const rounded = mb >= 10 ? Math.round(mb) : Math.round(mb * 10) / 10;
|
|
65
|
+
|
|
66
|
+
return `${rounded} ${units.mb}`;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
const gb = bytes / (1024 * 1024 * 1024);
|
|
70
|
+
const rounded = gb >= 10 ? Math.round(gb) : Math.round(gb * 10) / 10;
|
|
71
|
+
|
|
72
|
+
return `${rounded} ${units.gb}`;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function formatFileDescription(file: File, units: FileSizeUnits, descriptionOverride?: string): string {
|
|
76
|
+
if (descriptionOverride) {
|
|
77
|
+
return descriptionOverride;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
const extension = getFileExtension(file.name) ?? '';
|
|
81
|
+
const size = formatFileSize(file.size, units);
|
|
82
|
+
|
|
83
|
+
return extension ? `${extension}, ${size}` : size;
|
|
84
|
+
}
|