Upload

Upload предназначен для организации загрузки файлов на сервер. Он представляет собой прямоугольную область, в которую пользователь может складывать свои локальные файлы либо, нажав на неё, вызвать диалоговое окно выбора файлов для загрузки на сервер.

вКласс, свойство	Комментарий
Upload	Включенный класс компонента Upload
accept	Маска принимаемых файлов
multiple	Множественный выбор
sendImmed	Немедленная отправка
targetURL	Целевой адрес URL

Если с остальными свойствами всё предельно понятно, то Upload.sendImmed требует разъяснения. Дело в том, что пользователь может производить отправку файлов на сервер как непосредственно в процессе складывания пользователем файлов в Upload, так и при наступлении некоторого события (например, нажатии кнопки Submit). В первом случае требуется установка свойства Upload.sendImmed в true, что приведёт к автоматической моментальной отправке файла на сервер. Во втором требуется вставка его тела в JSON-строку параметров, передаваемых на сервер. При этом данные файла при помощи Web-API FileReader переводятся в base64-строку, которая, в свою очередь, передаётся серверу. Чтобы задействовать второй вариант, необходимо предварительно установить Upload.sendImmed в false, затем вызвать метод Upload.send(). Чтобы очистить массив передаваемых файлов, необходимо выполнить метод Upload.clear(). Нужно помнить, что FileReader имеет некоторые ограничения по размеру файлов. Предельный размер файла, который нам удалось передать таким методом на сервер, составил что-то около 126 Mб.