Към съдържанието

Типове полета

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 на прикачени файлове. Вижте преносими препратки към медийни файлове за подробности.

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

атрибути

Изобразява входни полета за атрибути на данни.

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-часов часовник. При 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, компонентът инициализира всички състояния, необходими за представяне на галерия. По подразбиране модалният прозорец на медията се отваря в режим за редактиране на галерията, но това може да се промени с флага addToGallery.
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 таг HTML. Полезен е за избор на нива на заглавия или семантични елементи.

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

Свойства

Свойство Тип Описание
default string Стойността по подразбиране, която се задава при първото добавяне на блока.
fallback string Резервната стойност, която се показва, когато стойността на полето е празна.
tags string | array Кои тагове да бъдат включени. Използвайте предварително зададен низ или масив от имена на тагове.
exclude array Тагове, които да бъдат изключени от предварително зададения набор. Прилага се само при използване на предварително зададен низ за tags.

икона

Извежда 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 Стойността, към която да се върне при натискане на бутона 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.

падащ списък

Извежда поле за избор с поддръжка на единичен или множествен избор.

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; ?>

Премахване на повторители

При премахване на ред се отваря диалоговият прозорец за потвърждение на редактора с бутоните Изтриване и Отказ. При отказ или натискане на 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 не го превръща автоматично във връзка, а щракването върху съществуваща връзка в полето не ви отвежда извън редактора. Атрибутите на връзките, запазени по-рано, остават в съществуващото съдържание; те не се мигрират автоматично.