Поле combo

Версия: Pro (advanced-fields).

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

Список из базы: ресурсы, шаблоны и другие разрешённые классы. Варианты подгружаются действием mgr/field/options и событием pbOnFieldValues. В инспекторе Select с поиском (filter) и свободным вводом (editable) поверх загруженных options. Окно выбора, как у relation, не открывается.

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

• Выбор шаблона, чанка или TV по классу xPDO
• Сохранение id связанной записи, если в chunk не нужен pagetitle
• Динамический список из таблицы MODX

Советы

Нужен ресурс с pagetitle в data: relation. Несколько значений: multicombo.

Похожие типы

• select для статического списка options
• tablecombo тоже список из класса MODX через optionsSource. Сетка в инспекторе у table

Настройка

{
  "name": "related",
  "type": "combo",
  "label": "Связанная",
  "optionsSource": {
    "class": "modResource"
  },
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Строка или id из optionsSource.

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

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

{
  "related": 5
}

Пример в chunk

modx

[[+related]]

fenom

{$related|pb_text}

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

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

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

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

Дальше

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