Типи полів
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, визначає відстань у 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. |
перемикачі
Відображає набір перемикачів.
{
"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. Це значення множиться на крок 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. |
список вибору
Відображає поле вибору з підтримкою одного або кількох варіантів.
{
"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. Якщо цю опцію ввімкнено, зміна також спрацьовує під час переходу до іншого поля. |
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; ?>
Видалення повторювача
Під час видалення рядка редактор відкриває діалог підтвердження з кнопками Delete і Cancel. Кнопка Cancel або клавіша 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 не перетворює його автоматично на посилання, а натискання на наявне посилання в полі не переводить зі сторінки редактора. Раніше збережені атрибути посилань залишаються в наявному вмісті; автоматична міграція не виконується.