Тип 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/ru/joomla-4/joomla-dlya-razrabotchikov/standartnye-tipy-polej-formy
