Редактор админки · 0.8.1

Формы: строки, колонки и размещение полей

Расположите поля в сетке из 12 колонок, добавьте секции и заголовки, не меняя модель данных.

На этой странице

Форма persistent-сущности состоит из вкладок → секций → строк → размещений полей. В строке доступно 12 колонок. Поле занимает часть этой ширины: 12 — вся строка, 6 — половина, 4 — треть.

Пример: форма ENTITY_NAME

Пусть в Content уже есть name, sku, price и description.

  1. Откройте Admin editor и выберите ENTITY_NAME.
  2. В Content fields нажмите + у полей, которые ещё не размещены.
  3. На макете перетащите sku рядом с name. Область вставки покажет, попадёт поле в строку или создаст новую.
  4. Выберите строку. В Properties → Row preset задайте Halves для равных колонок или Wide + narrow, если первое поле должно быть шире.
  5. Для description оставьте отдельную строку. Выберите размещение поля и задайте Width (columns) → 12 / 12.
  6. Нажмите Add section, чтобы добавить следующую группу. Выберите секцию и заполните Title и Description.

Перемещение и ширина

Действие или настройка Результат
Перетащить поле за его поверхность на макете Переместить размещение внутри строки или между строками
Перетащить строку за свободный край Переместить строку целиком
Отпустить над или под строкой Создать новую строку
Отпустить рядом с полем Добавить колонку; в заполненной строке ширина перераспределится
Width (columns) Задать ширину выбранного размещения от 1 до 12
Row preset и Row alignment Настроить пропорции и горизонтальное/вертикальное выравнивание
Move earlier / Move later Переместить выбранный элемент без перетаскивания
Move field to row / Move field to tab Перенести поле через Properties

Суммарная ширина строки не может превышать 12 колонок. Одно поле можно разместить только один раз во всём макете. Скрытые или удалённые поля Content размещать нельзя. Перед сохранением редактор покажет, какие ограничения нарушены.

Heading, Heading + description и Divider добавляют оформление, а не колонки БД. Для размещения булевого поля также доступен Compact control.

Удаление строки не удаляет поля

Корзина у строки убирает строку вместе с размещениями. Поля в Content и данные в БД сохраняются. Неразмещённые поля остаются в Other fields; их можно добавить обратно. Если поле не должно отображаться, используйте его настройки в Content: удаление размещения не скрывает данные и не ограничивает доступ.

Во время работы доступны Undo и Redo. Дальше проверьте предпросмотр и языки.

Неразмещённые поля и видимость

В Admin editor неразмещённые поля остаются видимыми в Other fields под макетом, чтобы их можно было вернуть в размещение. В сгенерированной форме это плоская раскрывающаяся кнопка Other fields (N) внизу; по умолчанию блок закрыт. Удаление размещения не удаляет поле или значения.

Hidden скрывает поле одновременно в списке и форме, Readonly оставляет чтение при редактировании. Отдельных настроек Show in table / Show in form сейчас нет. Убирать размещение в Other fields можно для организации формы, но это не ограничение доступа и не исключение поля из API.