Поле keyvalue

Версия: Pro.

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

Проще, чем table, если нужна одна текстовая колонка значения. Подписи колонок задают keyLabel и valueLabel. Число строк не ограничено списком колонок в схеме.

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

• Meta-атрибуты, params, простые specs
• Кастомные props для chunk
• Список «название: значение» без типов ячеек

Советы

Typed cells или image в ячейке: table. Одна плоская map иногда удобнее repeater из двух text.

Похожие типы

• table для typed grid
• repeater с двумя text для той же формы (Free)

Настройка

{
  "name": "meta",
  "type": "keyvalue",
  "label": "Мета",
  "keyLabel": "Параметр",
  "valueLabel": "Значение",
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Массив { key, value }.

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

Ключ meta в данных секции: массив пар:

{
  "meta": [
    {
      "key": "author",
      "value": "PageBuilder"
    },
    {
      "key": "version",
      "value": "1.0"
    }
  ]
}

Пример в chunk

modx

{foreach $meta as $row}
  <div><strong>{$row.key}:</strong> {$row.value}</div>
{/foreach}

fenom

{foreach $meta as $row}
  <div><strong>{$row.key|pb_text}:</strong> {$row.value|pb_text}</div>
{/foreach}

Примечание

Подписи колонок: keyLabel, valueLabel (или key_label / value_label).

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

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

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

• Дополнительно: keyLabel, valueLabel (или key_label / value_label).

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

Дальше

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