Тип imagelist поля форми являє собою список файлів зображень, що розкривається, в зазначеному каталозі. У списку відображаються лише файли з розширенням .png, .gif, .jpg, .bmp, .ico. Якщо поле має збережене значення, воно вибирається при першому завантаженні сторінки. Інакше вибирається значення за налаштуванням (якщо є).
За налаштуванням першим елементом у списку є «- Не використовувати -» (який дозволяється перекладати), йому привласнюється значення «-1», за яким слідує «- Використовувати за налаштуванням -» (також дозволяється перекладати) із заданим значенням «0».
- type (обов'язково) - має бути imagelist.
- name (обов'язково) – унікальне ім'я поля.
- label (обов'язково) (дозволяється перекладати) – описовий заголовок поля.
- directory (необов'язково) - це шлях файлової системи до каталогу, що містить файли зображень, які потрібно перерахувати. Якщо не вказано, передбачається каталог, заданий JPATH_ROOT.
- default (необов'язково) – ім'я файлу зображення за налаштуванням.
- description (необов'язково) (дозволяється перекладати) - це текст, який буде відображатися як спливаюча підказка, коли користувач наводить вказівник миші на список, що розкривається.
- filter (необов'язково) - це рядок регулярного виразу, який використовується для фільтрації списку файлів зображень, вибраних для включення в список, що розкривається. Якщо цей параметр не вказано, всі файли зображень у каталозі будуть включені. Вираз аргументу фільтра застосовується перед вираженням аргументу виключення. Для отримання інформації про побудову регулярних виразів див. регулярні вирази в аргументах параметрів.
- exclude (необов'язково) - це рядок регулярного виразу, який використовується для виключення файлів зображень зі списку. Вираз аргументу виключення застосовується після вираження аргументу фільтра. Для отримання інформації про побудову регулярних виразів див. регулярні вирази в аргументах параметрів.
- stripext (необов'язково) – логічний аргумент. Якщо true, розширення імен файлів буде видалено з перерахованих імен файлів зображень. Також зверніть увагу, що ім'я файлу буде збережено без розширення.
- hide_none (необов'язково) – логічний аргумент. Якщо це true, пункт «- Не використовувати -» виключається зі списку, що розкривається.
- hide_default (необов'язково) – логічний аргумент. Якщо це true, елемент «- Використовувати за налаштуванням -» виключається зі списку, що розкривається.
Приклад XML визначення
<field name="myimage" type="imagelist" default="" label="Select an image" description="" directory="" exclude="" stripext="" />
Переглянути всі стандартні типи полів форми можна тут: https://d-nik.site/joomla-4/joomla-dlia-rozrobnykiv/standartni-tipi-poliv-formi
