Тип поля формы 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>