__construct

Создает объект контрола выбора и загрузки файлов. Обычно метод не вызывают напрямую: используйте фабричный метод createInstance.

Синтаксис

public function __construct($params = array())

Параметры

Параметр	Тип	По умолчанию	Описание
`name`	`string`	`FILE[n#IND#]`	Имя HTML-поля. Маркер `#IND#` используется для нумерации нескольких файлов.
`id`	`string`	—	Идентификатор контрола. На его основе формируется JS-идентификатор вида `bx_file_...`.
`description`	`bool`	`true`	Показывать поле описания файла.
`delete`	`bool`	`true`	Показывать кнопку удаления файла в интерфейсе.
`edit`	`bool`	`true`	Разрешить редактирование изображений.
`upload`	`bool`	`false`	Включить загрузку файлов через AJAX.
`uploadType`	`string`	`path`	Формат значения после загрузки. Возможные значения: `path`, `hash`.
`medialib`	`bool`	`false`	Разрешить выбор из медиабиблиотеки. Требует модуль `fileman`, включенную медиабиблиотеку и права на ее просмотр.
`fileDialog`	`bool`	`false`	Разрешить выбор из структуры сайта. Требует права на просмотр файловой структуры.
`cloud`	`bool`	`false`	Разрешить загрузку из облачных хранилищ. Требует модуль `clouds`, активное хранилище и право `clouds_browse`.
`maxCount`	`int`	`0`	Максимальное количество файлов. Значение `0` означает без ограничения.
`maxSize`	`int`	`0`	Максимальный размер одного файла в байтах. Значение `0` означает без ограничения на стороне контрола.
`allowUpload`	`string`	`A`	Тип разрешенных файлов: `A` — любые файлы, `I` — изображения, `F` — расширения из `allowUploadExt`.
`allowUploadExt`	`string`	пустая строка	Список расширений для режима `allowUpload = F`.
`allowSort`	`string`	`Y`	Разрешить сортировку файлов. Чтобы отключить сортировку, передайте `N`.

Возвращаемое значение

Конструктор не возвращает значение.

Особенности работы

Если allowUpload содержит неподдерживаемое значение, используется режим A.
Если задан allowUpload = F, но allowUploadExt пустой, используется режим A.
Если параметр id не передан, идентификатор строится из значения name.
Если upload = true, параметры загрузки подписываются и передаются в JS-контрол.

Пример

<?php
$fileInput = new \Bitrix\Main\UI\FileInput([
    'id' => 'document_files',
    'name' => 'DOCUMENT_FILES[n#IND#]',
    'upload' => true,
    'allowUpload' => \Bitrix\Main\UI\FileInput::UPLOAD_EXTENTION_LIST,
    'allowUploadExt' => 'pdf,doc,docx',
    'maxSize' => 1024 * 1024 * 10,
]);

echo $fileInput->show($files);
?>