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