Поле colorpalette

Версия: Free.

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

Редактор выбирает цвет из заданного списка, а не любой код. Варианты задаются так же, как у select, только показаны образцами.

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

• Основные, дополнительные и приглушённые цвета темы
• Фон секции из готового набора

Советы

Свой код цвета вводят полем color.

Похожие типы

• color, если нужен любой цвет
• select, если образцы цвета не нужны

Настройка

{
  "name": "theme",
  "type": "colorpalette",
  "label": "Цвет",
  "swatches": [
    "#111827",
    "#c2410c"
  ],
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Строка: значение из swatches или value опции (обычно HEX), не CSS-правило.

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

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

{
  "theme": "#3b82f6"
}

Пример в chunk

modx

<span style="color: [[+theme]]">…</span>

fenom

<span style="color: {$theme|escape}">…</span>

Примечание

В панели управления: optionsText (как у select); при сохранении пишутся options и swatches.

Если в schema нет непустых options и swatches, инспектор показывает встроенную палитру из десяти HEX: #111827, #374151, #6b7280, #ef4444, #f97316, #eab308, #22c55e, #3b82f6, #8b5cf6, #ec4899.

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

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

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

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

Дальше

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