FileUploader

Отображает диалоговое окно для загрузки файлов

Используется для загрузки файлов в файловый сервис Платформы Multi-D. Согласно дизайн-системе Платформы Multi-D имеет несколько вариантов отображения и режимов работы.

Загружает файлы в файловый сервис, либо в переменные состояния экранной формы. Может отображатся в виде поля для выбора файла или в виде области с возможностью перетаскивания файла.

 <FileUploader
    Value-var="data.files"
    Text-Localizable="Web_client.Add files"
    OnFilesChange={() => getCommand('GetUploadLink')}
    OnFileCreate={(letterId = data.id) => getCommand('SaveFile', { letterId })}
    OnFileDelete={() => getCommand('DeleteFile')}
    OnClick={() => getCommand('GetDownloadLink')}
    OutputValue-var="data.files"
    OutputState-var="data.__fileUploaderBusy__"
    KeyMap={{ Name: 'fileName', Id: 'fileId' }}
    Multiple={true}
  />

Свойства

Имя	Описание	Тип	Значение по умолчанию	Возможные значения
AdditionalUploadInfo	Дополнительная информация о загрузке	string
AllowedFileTypes	Разрешенные расширения и/или MIME-типы файлов для загрузки в виде массива	array
Autofocus	Признак установки фокуса на компонент	boolean
CSS	Массив строк-классов CSS-стилей компонента	array
ChooseFileText	Текст на кнопке	string	Выберите файл
DataHint	Подсказка к компоненту	string
DeleteTooltipLabel	Текст подсказки для кнопки "Удалить"	string	Удалить
Disabled	Признак запрета на редактирование компонента	boolean
DownloadMode	Поведение компонента: скачивать или открывать файл по нажатию его в списке файлов	enum	Download	Download - Скачивание файла по нажатию его в списке файлов Open - Открытие файла по нажатию его в списке файлов
Error	Признак ошибки при валидации компонента	boolean
ErrorMessage	Сообщение об ошибке при валидации компонента	string
Focused	Признак фокусировки на компоненте	boolean
GetUrlCommand	Команда получения URL-адреса для загрузки файла	object
Hidden	Признак состояния компонента Скрыт	boolean
HighlightError	Признак подсвечивания ошибки	boolean
Hint	Подсказка над компонентом	string
HintPosition	Сторона — правая или левая — для отображения подсказки	enum	right	left - Слева right - Справа top - Сверху bottom - Снизу topRight - Сверху справа topLeft - Сверху слева bottomRight - Снизу справа bottomLeft - Снизу слева
Id	Идентификатор компонента для навигации к нему на HTML-странице	string
KeyMap	Имя переменной, которая доступна элементу списка файлов	object
Label	Надпись на компоненте	string
MaxFileSize	Максимальный размер файла (Мб)	number	10000
MaxLength	Максимальная длина вводимой строки	number	30
Mode	Режим работы компонента: загрузка файлов по URL-адресу, полученному функцией GetUrlCommand, или передача файлов переменной event в обработчик события OnFilesChange	enum	Default	Direct - Режим загрузки, при котором файлы передаются переменной event в обработчик события OnFilesChange этого компонента Default - Режим загрузки файлов по URL-адресу, полученному функцией GetUrlCommand
Model	Псевдоним свойств Value и OutputValue	any
Multiple	Возможность выбора нескольких файлов	boolean
NoWriteOnInit	Признак отказа от записи данных в переменную, заданную в свойствах OutputValue или Model, при создании компонента	boolean
OnBlur	Параметры команды, отправляемой при потере фокуса компонентом	undefined
OnChange	Параметры команды, отправляемой при изменении компонента, например, при вводе текста, выборе из списка	undefined
OnClick	Обработчик события по нажатию на файле в списке	object
OnDelay	Параметры команды, отправляемой по истечении секунды (для предотвращения ложного срабатывания обработчика события) после последнего изменения модели данных	undefined
OnDropLabel	Текст, отображаемый при размещении файла в области загрузки	string	Отпустите для начала загрузки...
OnEnterKeyDown	Параметры команды, отправляемой по нажатию Enter	undefined
OnFileCreate	Обработчик события о добавлении нового файла в список	object
OnFileDelete	Обработчик события об удалении файла из списка	object
OnFilesChange	Обработчик события об изменении списка файлов	object	OnFilesChange
OnFilesDelete	Обработчик события об удалении файла	object
OnKeyDown	Обработчик события KeyDown	undefined
OnKeyUp	Обработчик события KeyUp	undefined
OnMouseDown	Обработчик события MouseDown	undefined
OnMouseEnter	Обработчик события MouseEnter	undefined
OnMouseLeave	Обработчик события MouseLeave	undefined
OnMouseMove	Обработчик события MouseMove	undefined
OnMouseOut	Обработчик события MouseOut	undefined
OnMouseOver	Обработчик события MouseOver	undefined
OnMouseUp	Обработчик события MouseUp	undefined
OnUnmount	Обработчик события Unmount	undefined
OutputState	Имя переменной для сохранения состояния компонента	any
OutputValue	Привязка отрисованного компонента к модели	any
ReadOnly	Признак отображения компонента в режиме только для чтения	boolean
Required	Признак обязательности наличия загруженного файла	boolean
RestartTooltipLabel	Текст подсказки для кнопки "Повторить"	string	Повторить
Slot	Метка для динамического добавления другого компонента по его идентификатору	string
StopTooltipLabel	Текст подсказки для кнопки "Остановить"	string	Остановить
Text	Текст на кнопке выбора файла	string	Select file
Tooltip	Всплывающая подсказка над компонентом, чаще используемая для пояснения назначения значка	any
TraceId	Идентификатор для отслеживания состояния компонента исходя из хронологической последовательности: создание, отрисовка, обновление, удаление; используется для выполнения фрагмента кода по изменению состояния компонента	string
UploadFolder	Имя существующей папки для загрузки; имя папки должно содержать только строчные буквы и не содержать пробелы	string	uploadfiles
Validation	Признак ошибки валидации компонента; используется только для совместимости с версиями Платформы Multi-D до 0.6	boolean
Value	Привязка модели к отрисованному компоненту	any
Visible	Признак инверсии состояния компонента Скрыт	boolean	True
WithDropzone	Режим отображения компонента с областью для перетаскивания файла или без области c отображением только кнопки для открытия диалога выбора файла	boolean
WithPreview	Признак режима отображения списка загруженных файлов	boolean	True
WriteMode	Имя события, по которому меняется значение переменной состояния (экранной формы), переданной в качестве OutputValue	enum		- Режим ввода без контроля состояния компонента

Примеры

JSX:

<Group Mode={"Column"}>
  <FileUploader
    AllowedFileTypes={["text/html", ".txt"]}
    CSS={['mb-16']}
    Text="Перетащите или"
    ChooseFileText="выберите файл"
    GetUrlCommand={() => getCommand('UiKitFileUploaderGenerateUrlForUploadFile')}
    DownloadMode="Download"
    Multiple={true}
    Value-var="file1"
    OutputValue-var="file1"
    OutputState-var="__fileUploaderBusy__"
    WithDropzone={true}
    OnDropLabel="Отпустите для начала загрузки..."
    MaxFileSize={10000}
    AdditionalUploadInfo={'Максимальный размер файла 10000 Мб'}
  />
  <FileUploader
    CSS={['mb-16']}
    Text="Шаблон файла "
    GetUrlCommand={() => getCommand('UiKitFileUploaderGenerateUrlForUploadFile')}
    DownloadMode="Open"
    Multiple={true}
    Value-var="file"
    OutputValue-var="file"
    OutputState-var="__fileUploaderBusy__"
    ChooseFileText='Выберите файл'
    WithDropzone={false}
  />
  <Link
    CSS={['mb-16']}
    Mode="DownloadById"
    Visible={(fileId = file[0].token) => fileId}
    DownloadKind="Minio"
    DownloadId={(fileId = file[0].token) => fileId}
    Text="Скачать файл"
   />
   <FileUploader
    CSS={['mb-16']}
    Text="Шаблон настроек"
    GetUrlCommand={() => getCommand('UiKitFileUploaderGenerateUrlForUploadFile')}
    DownloadMode="Download"
    Multiple={false}
    Value-var="file2"
    OutputValue-var="file2"
    OutputState-var="__fileUploaderBusy__"
    ChooseFileText='Выберите файл'
    WithDropzone={false}
    Required={true}
  />
</Group>