Перейти до вмісту

Типи полів

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 не перетворює їх на ідентифікатори вкладень. Докладніше див. переносні медіапосилання.

Запити для вибору, повторні спроби та підмножини піктограм див. у розділі Завантаження піктограм.

атрибути

Відображає поля введення атрибутів даних.

JSON
{
  "type": "attributes"
}

Властивості

Властивість Тип Опис
default array Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback array Резервне значення, яке відображатиметься, якщо поле порожнє.
link boolean Дозволяє вибирати посилання зі спадного списку.
media boolean Дозволяє вибирати медіафайли зі спадного списку.

блок

Посилається на інший блок Blockstudio і розгортає його поля безпосередньо в цьому місці. У шаблонах значення повертає відрендерений вміст блоку.

JSON
{
  "type": "block"
}

Властивості

Властивість Тип Опис
block string Назва блоку, на який потрібно послатися (e.g., "mytheme/card").
returnFormat string Спосіб повернення значення в шаблонах.

прапорець

Відображає набір прапорців.

JSON
{
  "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.

JSON
{
  "type": "classes"
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback string Резервне значення, яке відображатиметься, якщо поле порожнє.
tailwind boolean Визначає, чи ввімкнути класи Tailwind для цього поля введення.

код

Відображає редактор коду.

JSON
{
  "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 як ресурс блоку, тож шаблону не потрібно виводити тег стилю чи скрипту.

колір

Відображає палітру кольорів і засіб вибору кольору.

JSON
{
  "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 Чи дозволити власний колір.

дата

Відображає засіб вибору дати.

JSON
{
  "type": "date"
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback string Резервне значення, яке відображатиметься, якщо поле порожнє.
startOfWeek number День, з якого починається тиждень. 0 — неділя, 1 — понеділок тощо.

дата й час

Відображає засіб вибору дати й часу.

JSON
{
  "type": "datetime"
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback string Резервне значення, яке відображатиметься, якщо поле порожнє.
is12Hour boolean Визначає, чи використовувати 12-годинний формат часу. У цьому форматі відображається перемикач AM/PM, а формат дати вважається MM-DD-YYYY (на відміну від стандартного DD-MM-YYYY).

файли

Відображає кнопку відкриття медіатеки. Вибрані елементи можна перевпорядковувати безпосередньо в списку.

JSON
{
  "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.

градієнт

Відображає палітру градієнтів і засіб вибору градієнту.

JSON
{
  "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 Чи дозволити власний колір.

група

Відображає кілька полів у (за потреби) згортаному контейнері.

JSON
{
  "type": "group"
}

Властивості

Властивість Тип Опис
title string Текст заголовка. Він відображається, навіть коли компонент закритий.
opened boolean Якщо встановити значення true, компонент залишатиметься відкритим незалежно від властивості initialOpen і
initialOpen boolean Визначає, чи буде панель відкритою на початку.
scrollAfterOpen boolean Прокручує вміст до видимої області.
class string Власний клас CSS, який застосовується до групи.
style object Власні стилі CSS, які застосовуються до групи.
attributes array Приймає всі інші типи полів, крім tabs.

HTML-тег

Відображає засіб вибору тегу HTML. Зручно для вибору рівнів заголовків або семантичних елементів.

JSON
{
  "type": "html-tag"
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback string Резервне значення, яке відображатиметься, якщо поле порожнє.
tags string | array Теги, які потрібно включити. Використовуйте рядок із готовим набором або масив назв тегів.
exclude array Теги, які потрібно виключити з готового набору. Застосовується лише, якщо для тегів використовується рядок із готовим набором.

піктограма

Відображає піктограму SVG з набору піктограм.

JSON
{
  "type": "icon"
}

Властивості

Властивість Тип Опис
default object Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback object Резервне значення, яке відображатиметься, якщо поле порожнє.
sets array | string Набір піктограм, який потрібно включити. Залиште порожнім, щоб включити всі.
subSets array | string Піднабір піктограм, який потрібно включити. Залиште порожнім, щоб включити всі.
returnFormat string Формат, у якому повертати піктограму.

Відображає елемент керування посиланнями для вибору внутрішніх або зовнішніх посилань.

JSON
{
  "type": "link"
}

Властивості

Властивість Тип Опис
default object Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback object Резервне значення, яке відображатиметься, якщо поле порожнє.
hasRichPreviews boolean Визначає, чи показувати розширені попередні перегляди під час додавання URL.
noDirectEntry boolean Визначає, чи перетворювати пошуковий запит на кшталт URL безпосередньо на посилання.
noURLSuggestion boolean Визначає, чи додавати резервну пропозицію, яка трактує пошуковий запит як URL.
opensInNewTab boolean Додає перемикач до модального вікна посилання.
showSuggestions boolean Визначає, чи показувати пропозиції під час введення URL.
textButton string Власний текст для відображення всередині кнопки посилання.
withCreateSuggestion boolean Визначає, чи можуть пошукові запити, за якими не знайдено посилань, створювати пропозицію нової чернетки сторінки.

повідомлення

Відображає повідомлення з власним вмістом.

JSON
{
  "type": "message"
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback string Резервне значення, яке відображатиметься, якщо поле порожнє.
value string Повідомлення для відображення. Дані блоку й атрибутів доступні в синтаксисі квадратних дужок e.g.: {block.title} або {attributes.text}

число

Відображає поле введення числа.

JSON
{
  "type": "number",
  "min": 0,
  "max": 100,
  "step": 1
}

Властивості

Властивість Тип Опис
default number Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback number Резервне значення, яке відображатиметься, якщо поле порожнє.
dragDirection string Визначає вісь перетягування для збільшення або зменшення значення.
dragThreshold number Якщо isDragEnabled має значення true, визначає відстань у px, яку потрібно подолати перетягуванням, перш ніж значення зміниться.
hideHTMLArrows boolean Якщо значення true, стандартні стрілки HTML поля введення будуть приховані.
isShiftStepEnabled boolean Якщо значення true, жест перетягування мишею збільшує або зменшує число. Утримування SHIFT під час перетягування збільшить крок зміни значення до shiftStep.
max number Максимальна довжина значення.
min number Мінімальна довжина значення.
required boolean Якщо значення true, примусово задається коректне число в діапазоні від min до max елемента керування. Якщо значення false, порожній рядок вважається коректним значенням.
shiftStep number Крок зміни значення, коли утримується клавіша SHIFT. Це значення множиться на крок step. Наприклад, якщо step дорівнює 5, а shiftStep — 10, кожне натискання збільшуватиме або зменшуватиме значення на 50.
step number Крок зміни значення під час збільшення або зменшення. Він також використовується для перевірки: щоб значення було коректним, воно має бути кратним step (зі зсувом на min, якщо задано). Приймає спеціальне рядкове значення any, яке вимикає це обмеження перевірки й задає крок збільшення або зменшення 1.

перемикачі

Відображає набір перемикачів.

JSON
{
  "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 Дозволяє користувачу очистити значення, повторно натиснувши вибраний перемикач.

повзунок

Відображає поле повзунка для встановлення числового значення між двома точками.

JSON
{
  "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. Це значення множиться на крок step. Наприклад, якщо step дорівнює 5, а shiftStep — 10, кожне натискання збільшуватиме або зменшуватиме значення на 50.
showTooltip boolean Примусово показує або приховує спливну підказку UI. Перевизначається значенням false, якщо для step встановлено спеціальне рядкове значення any.
step number Крок зміни значення під час збільшення або зменшення. Він також використовується для перевірки: щоб значення було коректним, воно має бути кратним step (зі зсувом на min, якщо задано). Приймає спеціальне рядкове значення any, яке вимикає це обмеження перевірки й задає крок збільшення або зменшення 1.
trackColor string CSS рядок кольору для налаштування фону доріжки.
withInputField boolean Визначає, чи відображати поле введення числа поруч із RangeControl. Перевизначається значенням false, якщо для step встановлено спеціальне рядкове значення any.

список вибору

Відображає поле вибору з підтримкою одного або кількох варіантів.

JSON
{
  "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, відображається кнопка скидання списку вибору.

вкладки

Відображає інтерфейс із вкладками для групування полів.

JSON
{
  "type": "tabs"
}

Властивості

Властивість Тип Опис
tabs array Вкладки для відображення.

текст

Відображає однорядкове поле введення тексту.

JSON
{
  "type": "text",
  "min": 0,
  "max": 100
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback string Резервне значення, яке відображатиметься, якщо поле порожнє.
max number Максимальна довжина значення.
min number Мінімальна довжина значення.

текстова область

Відображає поле введення текстової області.

JSON
{
  "type": "textarea",
  "min": 0,
  "max": 100,
  "rows": 4
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback string Резервне значення, яке відображатиметься, якщо поле порожнє.
max number Максимальна довжина значення.
min number Мінімальна довжина значення.
rows number Кількість рядків, які має містити текстова область.

перемикач

Відображає перемикач значення true/false.

JSON
{
  "type": "toggle"
}

Властивості

Властивість Тип Опис
default boolean Значення за замовчуванням, яке застосовується під час першого додавання блоку.
fallback boolean Резервне значення, яке відображатиметься, якщо поле порожнє.

повторювач

Відображає набір полів, які можна повторювати.

JSON
{
  "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.

JSON
{
  "type": "richtext"
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блока.
fallback string Резервне значення, яке відображатиметься, коли поле порожнє.

одиниця

Відображає числове поле з розкривним списком одиниць вимірювання.

JSON
{
  "type": "unit"
}

Властивості

Властивість Тип Опис
default string Значення за замовчуванням, яке застосовується під час першого додавання блока.
fallback string Резервне значення, яке відображатиметься, коли поле порожнє.
disableUnits boolean Якщо значення true, поле вибору одиниці приховано.
isPressEnterToChange boolean Якщо значення true, для виклику onChange потрібно натиснути клавішу ENTER. Якщо цю опцію ввімкнено, зміна також спрацьовує під час переходу до іншого поля.
isResetValueOnUnitChange boolean Якщо значення true й для вибраної одиниці задано значення за замовчуванням, це значення встановлюється під час зміни одиниці.
isUnitSelectTabbable boolean Визначає, чи можна перейти до поля вибору одиниці за допомогою клавіші Tab.
units array

візуальний редактор

Відображає WYSIWYG-редактор.

JSON
{
  "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
<?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; ?>

Видалення повторювача

Під час видалення рядка редактор відкриває діалог підтвердження з кнопками Delete і Cancel. Кнопка Cancel або клавіша Escape залишає рядок без змін. Рядок видаляється лише після підтвердження, зокрема у вкладених повторювачах.

textRemove керує однаковою поведінкою для кожного повторювача:

Значення Поведінка
Не задано, true або "" Показати типове запитання для підтвердження.
Непорожній рядок Показати це власне запитання, використовуючи наявний механізм перекладу власного тексту.
false Негайно видалити рядок без діалогового вікна.

Наприклад, "textRemove": "Remove this team member?" змінює запитання. Наявне обмеження min і далі забороняє видаляти рядки нижче мінімуму.

Вкладеність повторювачів

Ряд повторювача приймає всі типи полів, крім tabs. Поле tabs у рядку, навіть у групі без id, відображає в редакторі сповіщення замість своїх полів. Розширення PHPStan повідомляє про це для block.json і field.json. Залишайте поля рядка на одному рівні або перемістіть вкладки за межі повторювача.

Панель інструментів посилань WYSIWYG за замовчуванням вставляє посилання в тій самій вкладці, не додаючи target чи rel. Увімкніть параметр нової вкладки за допомогою toolbar.formats.link.opensInNewTab:

JSON
{
  "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 не перетворює його автоматично на посилання, а натискання на наявне посилання в полі не переводить зі сторінки редактора. Раніше збережені атрибути посилань залишаються в наявному вмісті; автоматична міграція не виконується.