Тип 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/joomla-4/joomla-dlia-rozrobnykiv/standartni-tipi-poliv-formi
