Типы полей
Blockstudio предлагает различные типы полей для создания интерфейсов блоков.
Проекты также могут регистрировать собственные типы полей с пространством имен с помощью
blockstudio/field_types. Используйте этот способ,
если нужен новый элемент управления редактора или структурированная форма значения. Используйте
custom/{name}пользовательские поля, если нужно только
повторно использовать группу существующих полей.
Кулинарная книга шаблонов полей
Практические рецепты: условные группы, умные списки выбора, повторители и хранилища с возможностью запросов.
Общие свойства
В таблице ниже перечислены общие свойства и распространённые варианты значений. default и fallback поддерживаются там, где они указаны в таблице свойств каждого типа поля.
| Свойство | Тип | Описание |
|---|---|---|
id |
string | Уникальный идентификатор атрибута |
type |
string | Тип поля |
label |
string | Метка, отображаемая в редакторе |
description |
string | Текст описания под полем |
default |
mixed | Значение поля по умолчанию |
fallback |
mixed | Резервное значение, если поле пустое |
help |
string | Текст подсказки, отображаемый во всплывающей подсказке рядом с меткой |
hidden |
boolean | Скрыть поле в UI |
switch |
boolean | Показывать переключатель, отключающий поле. По умолчанию — false. |
translate |
boolean | Установите false, чтобы исключить поле из конфигурации WPML |
conditions |
array | Правила условной логики |
Поля файлов со значением "returnFormat": "id" сохраняют импортированные строковые ссылки, включая одиночные значения в повторителях. Для неразрешённых имён отображаются резервные карточки без миниатюр; Blockstudio не преобразует их в идентификаторы вложений. Подробнее см. переносимые ссылки на медиафайлы.
Подробнее о запросах для средства выбора, повторных попытках и наборах значков см. в разделе Загрузка значков.
Атрибуты
Создает поля ввода атрибутов данных.
{
"type": "attributes"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
array |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
array |
Резервное значение, отображаемое, если поле пусто. |
link |
boolean |
Включает выбор ссылки из раскрывающегося списка. |
media |
boolean |
Включает выбор медиафайла из раскрывающегося списка. |
блок
Ссылается на другой блок Blockstudio, раскрывая его поля непосредственно в строке. В шаблонах возвращается отрисованный результат блока.
{
"type": "block"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
block |
string |
Имя блока, на который нужно сослаться (например, e.g, «mytheme/card»). |
returnFormat |
string |
Способ возврата значения в шаблонах. |
флажок
Отображает набор флажков.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
array | string | number |
Значение по умолчанию, которое применяется при первом добавлении блока. |
fallback |
array | string | number |
Резервное значение, отображаемое, если значение поля пустое. |
options |
array |
Варианты для выбора. |
returnFormat |
string |
Задает формат возвращаемого значения. |
populate |
object |
|
toggle |
boolean | string |
Добавляет над вариантами флажок, который выбирает или снимает выбор со всех вариантов. Строка задаёт его подпись, значение true использует подпись по умолчанию. |
классы
Отображает поле для выбора классов CSS.
{
"type": "classes"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
tailwind |
boolean |
Определяет, включить ли классы Tailwind для этого поля ввода. |
код
Отображает редактор кода.
{
"type": "code"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, которое применяется при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, когда поле пустое. |
autoCompletion |
boolean |
Включать ли автодополнение. |
foldGutter |
boolean |
Показывать ли поле сворачивания. |
height |
string |
Высота редактора. |
language |
string |
Язык для подсветки синтаксиса. |
lineNumbers |
boolean |
Отображать ли номера строк. |
maxHeight |
string |
Максимальная высота редактора. |
minHeight |
string |
Минимальная высота редактора. |
popout |
boolean |
Показывать ли кнопку открытия редактора во всплывающем окне. |
asset |
boolean |
Выводит CSS, SCSS или JavaScript из поля как ресурс блока, поэтому шаблону не нужно выводить тег стиля или скрипта. |
цвет
Отображает палитру цветов и средство выбора цвета.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение параметра, которое выбирается при первом добавлении блока. |
fallback |
string |
Значение параметра, отображаемое, когда поле пустое. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Должна ли в палитре быть кнопка сброса. |
disableCustomColors |
boolean |
Разрешать ли пользовательский цвет. |
дата
Отображает средство выбора даты.
{
"type": "date"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
startOfWeek |
number |
День, с которого начинается неделя: 0 — воскресенье, 1 — понедельник и т. д. |
дата и время
Отображает средство выбора даты и времени.
{
"type": "datetime"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
is12Hour |
boolean |
Использовать ли 12-часовой формат времени. В этом формате отображается переключатель AM/PM, а формат даты считается MM-DD-YYYY (в отличие от формата по умолчанию DD-MM-YYYY). |
файлы
Отображает кнопку открытия медиатеки. Выбранные элементы можно переупорядочивать прямо в строке.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
array | object | number |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
array | object | number |
Резервное значение, отображаемое, если поле пусто. |
addToGallery |
boolean |
Если значение равно true, модальное окно медиатеки открывается сразу на вкладке медиатеки, где пользователь может добавить изображения. Если значение равно false, окно открывается в режиме редактирования, где пользователь может изменить существующие изображения: переупорядочить их, удалить или изменить их атрибуты. Применяется, только если gallery === true. |
allowedTypes |
array | string |
Массив типов медиафайлов для загрузки или выбора из медиатеки. Каждый тип — это строка, которая может содержать общий тип MIME e.g: ‘image’, ‘audio’, ‘text’ или полный тип MIME e.g: ‘audio/mpeg’, ‘image/gif’. Если allowedTypes не задан, разрешены все типы MIME. |
gallery |
boolean |
Если значение равно true, компонент инициализирует все состояния, необходимые для отображения галереи. По умолчанию модальное окно медиафайлов открывается в режиме редактирования галереи, но это можно изменить с помощью addToGalleryflag. |
max |
number |
Максимальное количество файлов, которые можно добавить. |
min |
number |
Минимальное количество файлов, которые можно добавить. |
multiple |
boolean |
Разрешить ли множественный выбор. |
size |
boolean |
Добавляет в поле раскрывающийся список размеров медиафайлов. |
textMediaButton |
string |
Текст кнопки медиафайлов. |
title |
string |
Заголовок модального окна медиафайлов. |
returnFormat |
string |
Задает формат возвращаемого значения. |
returnSize |
string |
Размер медиафайла, возвращаемый при использовании формата возврата URL. |
градиент
Отображает палитру и средство выбора градиента.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение параметра, которое выбирается при первом добавлении блока. |
fallback |
string |
Значение параметра, отображаемое, когда поле пустое. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Должна ли в палитре быть кнопка сброса. |
disableCustomGradients |
boolean |
Разрешать ли пользовательский цвет. |
группа
Отображает несколько полей в (при необходимости) сворачиваемом контейнере.
{
"type": "group"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
title |
string |
Текст заголовка. Он отображается, даже когда компонент закрыт. |
opened |
boolean |
Если задано значение true, компонент останется открытым независимо от свойства initialOpen и |
initialOpen |
boolean |
Определяет, будет ли панель изначально открыта. |
scrollAfterOpen |
boolean |
Прокручивает содержимое в область видимости, когда оно отображается. |
class |
string |
Пользовательский класс CSS, который будет применен к группе. |
style |
object |
Пользовательские стили CSS, которые будут применены к группе. |
attributes |
array |
Принимает все остальные типы полей, кроме другого элемента tabs. |
html-тег
Отображает средство выбора тега HTML. Полезно для выбора уровня заголовка или семантического элемента.
{
"type": "html-tag"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
tags |
string | array |
Какие теги включить. Используйте предустановленную строку или массив имен тегов. |
exclude |
array |
Теги, которые следует исключить из предустановки. Применяется, только если для тегов используется предустановленная строка. |
значок
Отображает значок SVG из набора значков.
{
"type": "icon"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
object |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
object |
Резервное значение, отображаемое, если поле пусто. |
sets |
array | string |
Какой набор значков включить. Оставьте поле пустым, чтобы включить все наборы. |
subSets |
array | string |
Какой дополнительный набор значков включить. Оставьте поле пустым, чтобы включить все наборы. |
returnFormat |
string |
Формат возвращаемого значка. |
ссылка
Отображает элемент управления ссылками для выбора внутренних или внешних ссылок.
{
"type": "link"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
object |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
object |
Резервное значение, отображаемое, если поле пусто. |
hasRichPreviews |
boolean |
Показывать ли расширенный предпросмотр при добавлении элемента URL. |
noDirectEntry |
boolean |
Разрешить ли преобразование поискового запроса, похожего на URL, непосредственно в ссылку. |
noURLSuggestion |
boolean |
Добавлять ли запасной вариант, который рассматривает поисковый запрос как URL. |
opensInNewTab |
boolean |
Добавляет переключатель в модальное окно ссылки. |
showSuggestions |
boolean |
Показывать ли предложения при вводе URL. |
textButton |
string |
Пользовательский текст, отображаемый внутри кнопки ссылки. |
withCreateSuggestion |
boolean |
Могут ли запросы поиска ссылок без совпадений создавать предложение новой черновой страницы. |
сообщение
Отображает сообщение с пользовательским содержимым.
{
"type": "message"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
value |
string |
Отображаемое сообщение. Данные блока и атрибутов доступны в синтаксисе в квадратных скобках, например e.g: {block.title} или {attributes.text} |
число
Отображает поле ввода числа.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
number |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
number |
Резервное значение, отображаемое, если поле пусто. |
dragDirection |
string |
Определяет ось перетаскивания для увеличения или уменьшения значения. |
dragThreshold |
number |
Если isDragEnabled равно true, задает количество пикселей, которое нужно перетащить, прежде чем значение изменится. |
hideHTMLArrows |
boolean |
Если значение равно true, стандартные стрелки поля ввода HTML будут скрыты. |
isShiftStepEnabled |
boolean |
Если значение равно true, жест перетаскивания мышью увеличивает или уменьшает число. Удерживание SHIFT во время перетаскивания увеличивает значение на величину shiftStep. |
max |
number |
Максимальная длина значения. |
min |
number |
Минимальная длина значения. |
required |
boolean |
Если значение равно true, вводится только допустимое число в диапазоне от min до max элемента управления. Если значение равно false, пустая строка также считается допустимым значением. |
shiftStep |
number |
Величина приращения при удержании клавиши SHIFT. Это значение shift умножается на значение step. Например, если step равно 5, а shiftStep — 10, каждый шаг увеличит или уменьшит значение на 50. |
step |
number |
Величина изменения значения при его увеличении или уменьшении. Она также используется при проверке: значение должно быть кратно step (с учетом min, если он указан), чтобы считаться допустимым. Допускается специальное строковое значение any, которое отменяет это ограничение и задает изменение значения на 1 при каждом действии. |
переключатель
Отображает набор переключателей.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string | number |
Значение по умолчанию, которое применяется при первом добавлении блока. |
fallback |
string | number |
Резервное значение, отображаемое, когда поле пустое. |
options |
array |
Доступные варианты для выбора. |
returnFormat |
string |
Задает формат возвращаемого значения. |
populate |
object |
|
display |
string |
Установите значение buttonGroup, чтобы отображать варианты в виде группы кнопок вместо переключателей. |
allowNull |
boolean |
Позволяет пользователю сбросить значение, повторно нажав выбранный переключатель. |
диапазон
Отображает ползунок для задания числового значения между двумя точками.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
number |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
number |
Резервное значение, отображаемое, если поле пусто. |
allowReset |
boolean |
Если значение равно true, отображается кнопка сброса ползунка. |
initialPosition |
number |
Начальное положение ползунка, используемое, если значение не передано. Значение initialPosition будет ограничено значениями свойств min и max. |
isShiftStepEnabled |
boolean |
Если значение равно true, жест перетаскивания мышью увеличивает или уменьшает число. Удерживание SHIFT во время перетаскивания увеличивает значение на величину shiftStep. |
marks |
array |
Отображает отметки шагов. Пользовательские маркеры можно передать в виде массива. |
max |
number |
Максимальная длина значения. |
min |
number |
Минимальная длина значения. |
railColor |
string |
Строка цвета CSS для настройки фона направляющей ползунка. |
resetFallbackValue |
number |
Значение, к которому следует вернуться при нажатии кнопки сброса (включается параметром allowReset). |
separatorType |
string |
Определяет, отключена ли линия-разделитель под или над строкой элемента управления либо занимает всю ширину. По умолчанию она расположена снизу, не включая подчеркивание значка элемента управления. |
shiftStep |
number |
Величина приращения при удержании клавиши SHIFT. Это значение shift умножается на значение step. Например, если step равно 5, а shiftStep — 10, каждый шаг увеличит или уменьшит значение на 50. |
showTooltip |
boolean |
Принудительно показывает или скрывает всплывающую подсказку UI. При значении step, равном специальной строке any, этот параметр принудительно устанавливается в false. |
step |
number |
Величина изменения значения при его увеличении или уменьшении. Она также используется при проверке: значение должно быть кратно step (с учетом min, если он указан), чтобы считаться допустимым. Допускается специальное строковое значение any, которое отменяет это ограничение и задает изменение значения на 1 при каждом действии. |
trackColor |
string |
Строка цвета CSS для настройки фона дорожки ползунка. |
withInputField |
boolean |
Определяет, будет ли числовое поле отображаться рядом с RangeControl. При значении step, равном специальной строке any, этот параметр принудительно устанавливается в false. |
список
Отображает поле выбора с поддержкой одиночного и множественного выбора.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
array | string | number |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
array | string | number |
Резервное значение, отображаемое, если поле пусто. |
multiple |
boolean |
Если значение равно true, можно выбрать несколько вариантов. Параметр "stylisedUi" будет включен автоматически. |
options |
array |
Варианты для выбора. |
returnFormat |
string |
Задает формат возвращаемого значения. |
populate |
object |
|
stylisedUi |
boolean |
Отображает стилизованный список с возможностью поиска по элементам. |
allowNull |
boolean | string |
Разрешает выбрать пустой вариант. Если значение равно true, подпись будет пустой, иначе для варианта отобразится заданная строка. |
allowReset |
boolean |
Если значение равно true, отображается кнопка сброса списка. |
вкладки
Отображает интерфейс с вкладками для группировки полей.
{
"type": "tabs"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
tabs |
array |
Отображаемые вкладки. |
текст
Отображает однострочное текстовое поле ввода.
{
"type": "text",
"min": 0,
"max": 100
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
max |
number |
Максимальная длина значения. |
min |
number |
Минимальная длина значения. |
текстовая область
Отображает многострочное текстовое поле ввода.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
max |
number |
Максимальная длина значения. |
min |
number |
Минимальная длина значения. |
rows |
number |
Количество строк в текстовом поле. |
переключатель вкл./выкл.
Отображает переключатель true/false.
{
"type": "toggle"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
boolean |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
boolean |
Резервное значение, отображаемое, если поле пусто. |
повторитель
Выводит набор полей, которые можно повторять.
{
"type": "repeater",
"min": 0,
"max": 100
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
array |
Строки, с которыми создается новый блок. Каждая строка — объект со значениями полей. Имеет приоритет над строками, создаваемыми параметром min. |
min |
number |
Минимальное количество строк. |
max |
number |
Максимальное количество строк. |
minimized |
boolean |
Сворачивать существующие строки при открытии редактора. Строки, добавленные в редакторе, остаются развернутыми. |
textButton |
string |
Текст кнопки добавления. |
textMinimized |
string | object |
Текст, отображаемый, когда строки свернуты. |
textRemove |
string | boolean |
Вопрос подтверждения, который показывается в редакторе при удалении строки повторителя. Непустая строка заменяет вопрос; значение false удаляет строку сразу, без диалогового окна. Если параметр не задан, равен true или пустой строке, используется вопрос по умолчанию. |
attributes |
array |
Принимает любые типы полей, кроме другого поля вкладок. |
форматированный текст
Поле атрибута для полей RichText.
{
"type": "richtext"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
единица измерения
Выводит числовое поле с раскрывающимся списком единиц измерения.
{
"type": "unit"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, применяемое при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, если поле пусто. |
disableUnits |
boolean |
Если значение равно true, поле выбора единиц скрыто. |
isPressEnterToChange |
boolean |
Если значение равно true, для вызова onChange нужно нажать ENTER. Если этот параметр включен, изменение также фиксируется при переходе с помощью клавиши Tab. |
isResetValueOnUnitChange |
boolean |
Если значение равно true и для выбранной единицы задано значение по умолчанию, оно устанавливается при смене единиц. |
isUnitSelectTabbable |
boolean |
Определяет, доступно ли поле выбора единиц при навигации с помощью Tab. |
units |
array |
визуальный редактор
Выводит редактор WYSIWYG.
{
"type": "wysiwyg"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Значение по умолчанию, которое применяется при первом добавлении блока. |
fallback |
string |
Резервное значение, отображаемое, когда поле пустое. |
toolbar |
object |
Настройки панели инструментов редактора. |
mode |
string |
code открывает поле в режиме кода. both добавляет кнопку переключения между визуальным режимом и режимом кода. |
Загрузка значков
Редактор загружает набор значков, когда вы впервые открываете его средство выбора или меняете набор либо поднабор, а не при выборе блока. Поля, запрашивающие один и тот же набор, используют общий запрос, пока он выполняется. Сохраненное имя значка остается видимым до загрузки, а повторное открытие средства выбора запускает новую попытку после неудачного запроса.
tabler-icons поддерживает outline и filled. Явно настроенный для выбранного набора поднабор имеет приоритет; в противном случае средство выбора использует solid, если он доступен, или первый поднабор набора. Для наборов без поднаборов subSet не указывается.
Названия наборов сопоставляются только со встроенными файлами. При отображении на сайте кэшируются отдельные значки, а не целые наборы значков во временных записях базы данных.
Импортированные значения параметров
Флажки и списки выбора с "multiple": true обычно хранят массив объектов { "value": "...", "label": "..." }. Также поддерживаются отдельный объект варианта, скалярная строка или число, а также массив скалярных значений, импортированных через REST API или инструменты работы с контентом. Это также работает внутри строк повторителя.
В редакторе эти значения отображаются как выбранные, но при сохранении без изменений их сохраненная структура не меняется. Добавление или удаление варианта сохраняет обычный массив объектов вариантов. Числовое 0 и строковое "0" значения являются допустимыми вариантами. Шаблоны получают настроенное для поля returnFormat — так же, как и для значений, выбранных в редакторе. Варианты по-прежнему должны соответствовать объявленным или заполненным значениям поля.
Если у обычного списка с одним вариантом нет сохраненного значения или значения по умолчанию, он показывает неактивную пустую подсказку, а не первый вариант. При явном выборе первого варианта он сохраняется. После сохранения выбора подсказка исчезает. Используйте allowNull, если редакторам также нужно разрешить сбрасывать выбор: пустая подсказка сама по себе не позволяет сбросить обязательный выбор.
Начальные строки повторителя
В редакторе значения по умолчанию включают вложенные минимальные строки до вставки блока. Чтобы создать их, не нужно открывать настройки блока, а их добавление при вставке блока не создает второй шаг отмены.
Если для повторителя задано min, но нет сохраненного значения или явного default, сервер инициализирует указанное количество строк значениями по умолчанию для полей строк. Это также относится к PHP-вставкам, тегам блоков и источникам страниц на основе файлов, которые никогда не открывали в редакторе. Например, "min": 2 с текстовым полем, значением по умолчанию для которого задано "New item", выводит две строки с этим значением.
Сохранённые строки и явно заданный репитер default имеют приоритет. Явно сохранённый пустой список, false или null не восстанавливает удалённые строки. При рендеринге эти значения по умолчанию не записываются обратно в запись. min и max ограничивают элементы управления в редакторе, но не усекают и не дополняют сохранённый список при рендеринге. Используйте bs_validate_block(), чтобы сообщать о нарушениях ограничений на количество строк в импортированном содержимом.
Поля строк без default в созданной строке false, поэтому такая строка не содержит данных. Строки, добавленные редакторами и оставленные пустыми, выглядят так же. Шаблон, который выводит карточку, заголовок или элемент списка для каждой строки, должен пропускать строки без данных вне редактора и оставлять их в редакторе, чтобы их поля можно было редактировать:
<?php foreach ( $a['items'] as $item ) : ?>
<?php if ( ! $isEditor && ! $item['title'] && ! $item['text'] ) continue; ?>
<div class="item">
<h3><?php echo $item['title']; ?></h3>
<p><?php echo $item['text']; ?></p>
</div>
<?php endforeach; ?>
Удаление повторителей
При удалении строки открывается диалог подтверждения редактора с кнопками Удалить и Отмена. Нажатие «Отмена» или клавиши Escape оставляет строку без изменений. Строка удаляется только после подтверждения, в том числе во вложенных повторителях.
textRemove управляет этим поведением для всех повторителей:
| Значение | Поведение |
|---|---|
Не указано, true или "" |
Показать стандартный запрос подтверждения. |
| Непустая строка | Показать этот текст запроса, используя существующий механизм перевода пользовательского текста. |
false |
Немедленно удалить строку без диалога. |
Например, "textRemove": "Remove this team member?" меняет текст запроса.
Существующее ограничение min по-прежнему запрещает удалять строки ниже минимального количества.
Вложенность повторителей
Строка репитера принимает поля всех типов, кроме tabs. Поле tabs в строке, в том числе внутри группы без id, отображает в редакторе уведомление вместо своих полей. Расширение PHPStan сообщает об этом для block.json и field.json. Оставляйте поля строки на одном уровне или переместите вкладки за пределы репитера.
Ссылки WYSIWYG
Панель инструментов ссылок WYSIWYG вставляет ссылки, открывающиеся в той же вкладке, без добавления target или rel по умолчанию. Включите параметр новой вкладки с помощью toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
При выборе новой вкладки добавляются target="_blank" и rel="noreferrer noopener".
При отключении этого параметра автоматические атрибуты удаляются. Чтобы применять атрибуты ко всем ссылкам в этом поле, задайте toolbar.formats.link.attributes, например
{ "class": "content-link", "rel": "nofollow" }. Явная конфигурация сохраняется, а токены безопасности для новых вкладок добавляются в настроенный rel.
Ввод URL не превращает его автоматически в ссылку, а нажатие на существующую ссылку в поле не уводит из редактора. Ранее сохраненные атрибуты ссылок остаются в существующем содержимом; автоматической миграции не происходит.