Тип file поля формы предоставляет поле ввода для файлов.
- type (обязательно) - должен быть file.
- name (обязательно) - уникальное имя поля.
- label (обязательно) (разрешается переводить) - описательный заголовок поля.
- description (необязательно) (разрешается переводить) - это текст, который будет отображаться как всплывающая подсказка, когда пользователь наводит указатель мыши на раскрывающийся список.
- default (необязательно) (не разрешается переводить) - значение по умолчанию, но не имеет большого значения для файла.
- size (необязательно) - ширина поля файла в символах.
- accept (необязательно) - сообщает браузеру, какие типы MIME разрешены для загрузки в вашу форму.
- class (необязательно) - это имя класса CSS для поля формы HTML.
- labelclass (необязательно) - добавляет класс CSS для метки поля формы; для Joomla 2.5.4+
- disabled (необязательно) - эквивалентный атрибут HTML.
- onchange (необязательно) - эквивалентный атрибут HTML (используется javascript).
- required не может использоваться с этим типом поля. Если поле помечено как обязательное, проверка всегда будет неудачной, независимо от того, был ли файл загружен или нет.
- validate (необязательно) - следует ли Joomla проверять поле в соответствии с правилами.
- showon (необязательно) - позволяет скрыть поле на основе значения (значений) другого поля; для Joomla 3.2.4+
- multiple (необязательно) - позволяет загружать несколько файлов одновременно, если установлено значение multiple="true".
Пример XML определения
<field name="myfilevalue" type="file" label="Enter some text" description="Choose an image from your computer with maximum 100KB" size="10" accept="image/*" />
Примечание 1. При использовании типа ввода файла вы всегда должны добавлять атрибут enctype="multipart/form-data" к тегу формы. В противном случае загруженные файлы не будут правильно прикреплены.
Примечание 2. Вы можете установить ограничение на размер файла, добавив скрытое поле с name="MAX_FILE_SIZE" и указав максимально допустимые байты, которые обрабатываются php, но вы также должны обрабатывать это в своем коде с ним или без него.
Посмотреть все стандартные типы полей формы можно здесь: https://d-nik.site/ru/joomla-4/joomla-dlya-razrabotchikov/standartnye-tipy-polej-formy
