Тип 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/joomla-4/joomla-dlia-rozrobnykiv/standartni-tipi-poliv-formi

Джерело: https://docs.joomla.org/Groupedlist_form_field_type

Main Menu