Тип filelist поля формы Joomla

Тип filelist поля формы представляет собой раскрывающийся список файлов из указанного каталога. Если в поле есть сохраненное значение, оно выбирается при первой загрузке страницы. В противном случае выбирается значение по умолчанию (если есть).

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

Источник: https://docs.joomla.org/Filelist_form_field_type

Main Menu