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

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

• type (обязательный) - должен быть groupedlist.
• name (обязательно) - уникальное имя поля.
• label (обязательно) (разрешается переводить) - описательный заголовок поля.
• default (необязательно) - значение элемента списка по умолчанию.
• description (необязательно) (разрешается переводить) - это текст, который будет отображаться как всплывающая подсказка, когда пользователь наводит указатель мыши на раскрывающийся список.
• class (необязательно) - это имя класса CSS для поля формы HTML. Если этот параметр не указан, по умолчанию используется 'inputbox'.
• multiple (необязательно) - можно ли выбрать несколько элементов одновременно (true или false).

Элемент XML <field> должен включать один или несколько элементов <option>, которые определяют элементы списка. Текст между тегами <option> и </option> - это то, что будет отображаться в раскрывающемся списке и является переводимой строкой. Тег <option> принимает следующий аргумент:

• value (обязательный) - это значение, которое будет сохранено для поля, если этот элемент выбран.

Совет: не забудьте закрыть определение поля с помощью </field>.

Чтобы сгруппировать данные, просто поместите <group> перед элементами <option>, которые вы хотите сгруппировать, и </group> после них. Тег <group> принимает следующий аргумент:

• label (разрешается переводить) - текст, показанный в списке.

Пример XML определения

<field name="mylistvalue" type="groupedlist" default="" label="Select an option" description="">
  <group label="Group 1">
    <option value="0">Option 1</option>
    <option value="1">Option 2</option>
  </group>
  <group label="Group 2">
    <option value="3">Option 3</option>
    <option value="4">Option 4</option>
  </group>
  <option value="5">Option 5</option>
  <option value="6">Option 6</option>
</field>

Посмотреть все стандартные типы полей формы можно здесь: https://d-nik.site/ru/joomla-4/joomla-dlya-razrabotchikov/standartnye-tipy-polej-formy

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