__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);
?>

Пользовательские комментарии

Помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх