Skip to content
PageBuilder
Визуальный конструктор секций для MODX 3: черновик и публикация без перезаписи content ресурса
  1. Компоненты
  2. PageBuilder
  3. Типы полей
  4. Free
  5. select

Поле select

Версия: Free.

Зачем этот тип

  • Список в JSON секции, без запросов к xPDO
  • На длинном перечне компактнее radio
  • В data пишется value опции, не label

Когда использовать

  • Размер, тема, выравнивание, preset макета
  • От 5 до 20 фиксированных вариантов без поиска
  • Настройки секции в духе enum

Советы

  • Список из БД: combo (Pro)
  • Два–четыре варианта на экране удобнее в radio

Похожие типы

  • radio для короткого списка на экране
  • multiselect для нескольких статических options

Настройка

json
{
  "name": "size",
  "type": "select",
  "label": "Размер",
  "options": [
    {
      "label": "S",
      "value": "sm"
    },
    {
      "label": "L",
      "value": "lg"
    }
  ],
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Строка: value выбранной опции.

Данные секции

Ключ size в данных секции — строка value выбранной опции:

json
{
  "size": "lg"
}

Пример в chunk

fenom
{switch $size}
  {case 'sm'}<div class="block block--sm">{/case}
  {case 'lg'}<div class="block block--lg">{/case}
  {default}<div class="block">{/default}
{/switch}

Примечание

Динамический список: optionsSource → processor mgr/field/options.

Общие свойства

Для полей с name, которые сохраняются в данных секции:

КлючТипРольПанель
tabstringПодзаголовок группы в инспектореда
width25–100Ширина поля в % строки (flex)да
descriptionstringПодсказка под подписьюда
defaultanyНачальное значение новой секциида
activeboolfalse — скрыть поле в инспектореда
requiredboolОбязательно при publish (черновик сохраняется)да
  • Дополнительно: options или optionsSource.

Подробнее: обзор полей.

Дальше