Поле checkboxgroup

Версия: Free.

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

Несколько флажков из одного списка options. В данных секции массив строк value, не объекты.

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

• Теги фильтра, набор иконок, флаги возможностей
• «Какие колонки показать» из фиксированного набора

Советы

Один флаг: checkbox.

Похожие типы

• multiselect для MultiSelect с поиском
• tag для свободного ввода строк

Настройка

{
  "name": "tags",
  "type": "checkboxgroup",
  "label": "Теги",
  "options": [
    {
      "label": "Новинка",
      "value": "new"
    },
    {
      "label": "Хит",
      "value": "hit"
    }
  ],
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Массив строк (value отмеченных опций).

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

Ключ tags в данных секции:

{
  "tags": [
    "new",
    "hit"
  ]
}

Пример в chunk

modx

<!-- Массив `tags` теги MODX не обходят: перебор задайте сниппетом, цикл напишите в блоке Fenom -->

fenom

{foreach $tags as $tag}
  <span class="tag">{$tag|pb_text}</span>
{/foreach}

Примечание

Опции из options или optionsSource, как у select.

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

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

Ключ	Тип	Роль	Панель
tab	string	Подзаголовок группы в инспекторе	да
width	25, 33, 50, 66, 75, 100	Ширина поля в % строки (flex); в CMP только эти значения	да
description	string	Подсказка под подписью	да
default	any	Начальное значение новой секции	да
active	bool	false: скрыть поле в инспекторе	да
required	bool	Обязательно при publish (черновик сохраняется)	да

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

Дальше

• Справочник типов
• Обзор полей