Тип file поля форми Joomla

Тип 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

Джерело: https://docs.joomla.org/File_form_field_type

Main Menu