Тип folderlist поля форми являє собою список папок, що розкривається, із зазначеного каталогу. Якщо поле має збережене значення, воно вибирається при першому завантаженні сторінки. В іншому випадку вибирається значення за налаштуванням (якщо є).
За налаштуванням першим елементом у списку є «-Не використовувати-» (який дозволяється перекладати), йому надається значення «-1», за яким слідує «-Використовувати за налаштуванням-»</em > (також перекладається) з урахуванням значення «0».
- type (обов'язково) має бути folderlist.
- name (обов'язково) – унікальне ім'я поля.
- label (обов'язково) (дозволяється перекладати) – описовий заголовок поля.
- directory (обов'язково) - це шлях файлової системи до каталогу, що містить папки, що перераховуються.
- default (необов'язково) – ім'я папки за налаштуванням.
- description (необов'язково) (дозволяється перекладати) - це текст, який буде відображатися як спливаюча підказка, коли користувач наводить вказівник миші на список, що розкривається.
- filter (Joomla 3.x) або folderFilter (Joomla 4.0 і пізніші версії) (необов'язково) - це рядок регулярного виразу, який використовується для фільтрації списку папок, вибраних для включення в список, що розкривається. Якщо цей параметр не вказано, всі папки в каталозі будуть включені. Вираз аргументу фільтра застосовується перед вираженням аргументу виключення. Для отримання інформації про побудову регулярних виразів див. регулярні вирази в аргументах параметрів.
- exclude (необов'язково) - це рядок регулярного виразу, який використовується для виключення папок зі списку. Вираз аргументу виключення застосовується після вираження аргументу фільтра. Для отримання інформації про побудову регулярних виразів див. регулярні вирази в аргументах параметрів.
- hide_none (необов'язково) – логічний аргумент. Якщо це true, то елемент «-Не вибрано-» у списку, що розкривається, виключається.
- hide_default (необов'язково) – логічний аргумент. Якщо це true, елемент «-Використовувати за налаштуванням-» у списку, що розкривається, виключається.
- recursive (необов'язково) – логічний аргумент. Якщо це true, список папок включає всі знайдені підпапки. Увага: якщо у вас багато підпапок, це може сповільнити завантаження сторінки.
Приклад XML визначення
<field name="myfolder" type="folderlist" default="" label="Select a folder" directory="administrator" filter="" exclude="" stripext="" />Переглянути всі стандартні типи полів форми можна тут: https://d-nik.site/joomla-4/joomla-dlia-rozrobnykiv/standartni-tipi-poliv-formi
Пригостити автора кавою