Типове полета
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 не ги преобразува в ID на прикачени файлове. Вижте
преносими препратки към медийни файлове за подробности.
Вижте Зареждане на икони за заявки от инструмента за избор, повторни опити и подмножества от икони.
атрибути
Изобразява входни полета за атрибути на данни.
{
"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-часов часовник. При 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, компонентът инициализира всички състояния, необходими за представяне на галерия. По подразбиране модалният прозорец на медията се отваря в режим за редактиране на галерията, но това може да се промени с флага addToGallery. |
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 таг HTML. Полезен е за избор на нива на заглавия или семантични елементи.
{
"type": "html-tag"
}
Свойства
| Свойство | Тип | Описание |
|---|---|---|
default |
string |
Стойността по подразбиране, която се задава при първото добавяне на блока. |
fallback |
string |
Резервната стойност, която се показва, когато стойността на полето е празна. |
tags |
string | array |
Кои тагове да бъдат включени. Използвайте предварително зададен низ или масив от имена на тагове. |
exclude |
array |
Тагове, които да бъдат изключени от предварително зададения набор. Прилага се само при използване на предварително зададен низ за tags. |
икона
Извежда 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 |
Стойността, към която да се върне при натискане на бутона Reset (активиран чрез 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; ?>
Премахване на повторители
При премахване на ред се отваря диалоговият прозорец за потвърждение на редактора с бутоните Изтриване и Отказ. При отказ или натискане на 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 не го превръща автоматично във връзка, а щракването върху съществуваща връзка в полето не ви отвежда извън редактора. Атрибутите на връзките, запазени по-рано, остават в съществуващото съдържание; те не се мигрират автоматично.