Přejít k obsahu

Typy polí

Blockstudio nabízí různé typy polí pro tvorbu rozhraní bloků.

Projekty si mohou také zaregistrovat vlastní typy polí se jmenným prostorem pomocí blockstudio/field_types. Použijte je, když potřebujete nový ovládací prvek editoru nebo strukturovaný tvar hodnoty. Pokud potřebujete pouze znovu použít skupinu existujících polí, použijte pole custom/{name}.

Kuchařka vzorů polí

Praktické postupy: podmíněné skupiny, chytré výběry, opakovače a úložiště s možností dotazování.

Obecné vlastnosti

Níže uvedená tabulka uvádí sdílené vlastnosti a běžné možnosti hodnot. default a fallback jsou podporovány tam, kde jsou uvedeny v tabulce vlastností každého typu pole.

Vlastnost Typ Popis
id string Jedinečný identifikátor atributu
type string Typ pole
label string Popisek zobrazený v editoru
description string Popisný text zobrazený pod polem
default mixed Výchozí hodnota pole
fallback mixed Náhradní hodnota, když je pole prázdné
help string Text nápovědy zobrazený jako popisek po najetí vedle názvu
hidden boolean Skrýt pole v UI
switch boolean Zobrazit přepínač, kterým lze pole deaktivovat. Výchozí hodnota je false.
translate boolean Nastavením na false pole vynecháte z konfigurace WPML
conditions array Pravidla podmíněné logiky

Pole pro soubory s "returnFormat": "id" zachovávají importované řetězcové odkazy, včetně jednotlivých hodnot uvnitř opakovačů. U nevyřešených názvů se zobrazí náhradní karty bez miniatur; Blockstudio je nepřevádí na ID příloh. Podrobnosti najdete v části Odkazy na přenosná média.

Požadavky výběrového dialogu, opakované pokusy a podmnožiny ikon najdete v části Načítání ikon.

attributes

Vykresluje vstupy pro datové atributy.

JSON
{
  "type": "attributes"
}

Vlastnosti

Vlastnost Typ Popis
default array Výchozí hodnota, která se použije při prvním přidání bloku.
fallback array Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
link boolean Povolí výběr odkazu z rozbalovací nabídky.
media boolean Povolí výběr médií z rozbalovací nabídky.

blok

Odkazuje na další blok Blockstudio a zobrazí jeho pole přímo v bloku. V šablonách vrací hodnotu v podobě vykresleného výstupu bloku.

JSON
{
  "type": "block"
}

Vlastnosti

Vlastnost Typ Popis
block string Název bloku, na který se má odkazovat (e.g např. „mytheme/card“).
returnFormat string Určuje, jak se má hodnota vracet v šablonách.

zaškrtávací políčko

Vykreslí sadu zaškrtávacích políček.

JSON
{
  "type": "checkbox",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Vlastnosti

Vlastnost Typ Popis
default array | string | number Výchozí hodnota, která se má použít při prvním přidání bloku.
fallback array | string | number Náhradní hodnota, která se zobrazí, když je hodnota pole prázdná.
options array Možnosti, ze kterých lze vybírat.
returnFormat string Určuje formát vrácené hodnoty.
populate object
toggle boolean | string Přidá nad možnosti zaškrtávací políčko, kterým lze vybrat nebo zrušit výběr všech možností. Jako jeho popisek se použije řetězec; při hodnotě true se použije výchozí popisek.

třídy

Vykreslí pole pro výběr tříd CSS.

JSON
{
  "type": "classes"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
tailwind boolean Určuje, zda se pro toto vstupní pole mají povolit třídy Tailwind.

kód

Vykreslí editor kódu.

JSON
{
  "type": "code"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
autoCompletion boolean Zda povolit automatické doplňování.
foldGutter boolean Zda zobrazit okraj pro skládání kódu.
height string Výška editoru.
language string Jazyk použitý pro zvýrazňování syntaxe.
lineNumbers boolean Zda zobrazit čísla řádků.
maxHeight string Maximální výška editoru.
minHeight string Minimální výška editoru.
popout boolean Zda zobrazit tlačítko, které otevře editor ve vyskakovacím okně.
asset boolean Vykreslí CSS, SCSS nebo JavaScript z pole jako prostředek bloku, takže šablona nemusí vypisovat značku style ani script.

barva

Vykreslí paletu barev a výběr barvy.

JSON
{
  "type": "color",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Vlastnosti

Vlastnost Typ Popis
default string Hodnota možnosti, která se vybere při prvním přidání bloku.
fallback string Hodnota možnosti, která se zobrazí, když je hodnota pole prázdná.
options array
populate object
clearable boolean Zda má mít paleta tlačítko pro vymazání.
disableCustomColors boolean Zda povolit vlastní barvu.

datum

Vykreslí výběr data.

JSON
{
  "type": "date"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
startOfWeek number Den, kterým má týden začínat. 0 pro neděli, 1 pro pondělí atd.

datum a čas

Vykreslí výběr data a času.

JSON
{
  "type": "datetime"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
is12Hour boolean Určuje, zda se používá 12hodinový formát času. Při tomto formátu se zobrazuje ovládací prvek AM/PM a předpokládá se formát data MM-DD-YYYY (na rozdíl od výchozího formátu DD-MM-YYYY).

soubory

Vykreslí tlačítko pro otevření knihovny médií. Vybrané položky lze přímo přeuspořádat.

JSON
{
  "type": "files",
  "min": 0,
  "max": 100,
  "multiple": false
}

Vlastnosti

Vlastnost Typ Popis
default array | object | number Výchozí hodnota, která se použije při prvním přidání bloku.
fallback array | object | number Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
addToGallery boolean Pokud je hodnota true, dialog galerie médií se otevře přímo v knihovně médií, kde může uživatel přidat další obrázky. Pokud je hodnota false, dialog galerie médií se otevře v režimu úprav, kde může uživatel upravit stávající obrázky jejich přeuspořádáním, odebráním nebo změnou jejich atributů. Platí pouze v případě, že gallery === true.
allowedTypes array | string Pole s typy médií, které lze nahrát nebo vybrat z knihovny médií. Každý typ je řetězec a může obsahovat obecný typ MIME e.g: „image“, „audio“, „text“ nebo úplný typ MIME e.g: „audio/mpeg“, „image/gif“. Pokud není nastaveno allowedTypes, jsou povoleny všechny typy MIME.
gallery boolean Pokud je hodnota true, komponenta nastaví všechny stavy potřebné pro zobrazení galerie. Dialog médií se ve výchozím nastavení otevře v režimu úprav galerie, což lze změnit pomocí příznaku addToGalleryflag.
max number Maximální počet souborů, které lze přidat.
min number Minimální počet souborů, které lze přidat.
multiple boolean Určuje, zda lze vybrat více položek.
size boolean Přidá do pole rozbalovací nabídku velikostí médií.
textMediaButton string Text tlačítka médií.
title string Nadpis zobrazený v dialogu médií.
returnFormat string Určuje formát vrácené hodnoty.
returnSize string Velikost média, která se vrátí při použití formátu URL.

přechod

Vykreslí paletu přechodů a výběr přechodu.

JSON
{
  "type": "gradient",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Vlastnosti

Vlastnost Typ Popis
default string Hodnota možnosti, která se vybere při prvním přidání bloku.
fallback string Hodnota možnosti, která se zobrazí, když je hodnota pole prázdná.
options array
populate object
clearable boolean Zda má mít paleta tlačítko pro vymazání.
disableCustomGradients boolean Zda povolit vlastní barvu.

skupina

Vykreslí více polí v (případně) sbalitelném kontejneru.

JSON
{
  "type": "group"
}

Vlastnosti

Vlastnost Typ Popis
title string Text nadpisu. Zobrazuje se i při zavřené komponentě.
opened boolean Je-li nastaveno na true, komponenta zůstane otevřená bez ohledu na vlastnost initialOpen a
initialOpen boolean Určuje, zda bude panel při otevření již rozbalený.
scrollAfterOpen boolean Při zobrazení posune obsah do viditelné oblasti.
class string Vlastní třída CSS použitá pro skupinu.
style object Vlastní styly CSS použité pro skupinu.
attributes array Přijímá všechny ostatní typy polí kromě dalšího typu tabs.

html-tag

Vykreslí selektor značek HTML. Hodí se k výběru úrovně nadpisu nebo sémantických prvků.

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

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
tags string | array Které značky zahrnout. Použijte přednastavený řetězec nebo pole názvů značek.
exclude array Značky, které se mají z přednastaveného seznamu vyloučit. Platí pouze při použití přednastaveného řetězce pro tags.

ikona

Vykreslí ikonu SVG ze sady ikon.

JSON
{
  "type": "icon"
}

Vlastnosti

Vlastnost Typ Popis
default object Výchozí hodnota, která se použije při prvním přidání bloku.
fallback object Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
sets array | string Kterou sadu ikon zahrnout. Ponechte prázdné pro zahrnutí všech.
subSets array | string Kterou podsadu ikon zahrnout. Ponechte prázdné pro zahrnutí všech.
returnFormat string Formát, ve kterém se má ikona vrátit.

Vykreslí ovládací prvek pro výběr interních nebo externích odkazů.

JSON
{
  "type": "link"
}

Vlastnosti

Vlastnost Typ Popis
default object Výchozí hodnota, která se použije při prvním přidání bloku.
fallback object Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
hasRichPreviews boolean Určuje, zda se při přidání položky URL mají zobrazovat bohaté náhledy.
noDirectEntry boolean Určuje, zda lze vyhledávací dotaz ve stylu URL přímo převést na odkaz.
noURLSuggestion boolean Určuje, zda se má přidat záložní návrh, který vyhledávací dotaz považuje za URL.
opensInNewTab boolean Přidá do dialogu odkazu přepínač.
showSuggestions boolean Určuje, zda se mají při psaní URL zobrazovat návrhy.
textButton string Vlastní text zobrazený uvnitř tlačítka odkazu.
withCreateSuggestion boolean Určuje, zda mohou neúspěšná hledání odkazů vytvořit návrh nové stránky konceptu.

zpráva

Vykreslí zprávu s vlastním obsahem.

JSON
{
  "type": "message"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
value string Zpráva, která se má zobrazit. Údaje bloku a atributů jsou dostupné ve hranaté syntaxi, e.g např.: {block.title} nebo {attributes.text}

číslo

Vykreslí vstupní pole pro číslo.

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

Vlastnosti

Vlastnost Typ Popis
default number Výchozí hodnota, která se použije při prvním přidání bloku.
fallback number Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
dragDirection string Určuje osu přetažení pro zvýšení nebo snížení hodnoty.
dragThreshold number Je-li isDragEnabled true, určuje počet px přetažení, po kterém se hodnota změní.
hideHTMLArrows boolean Je-li hodnota true, skryjí se výchozí šipky HTML vstupního pole.
isShiftStepEnabled boolean Je-li hodnota true, umožní gestem tažení myší zvýšit nebo snížit číselnou hodnotu. Podržením klávesy SHIFT při tažení se hodnota zvýší o shiftStep.
max number Maximální délka hodnoty.
min number Minimální délka hodnoty.
required boolean Je-li hodnota true, vynutí platné číslo v rozsahu min/max ovládacího prvku. Je-li hodnota false, povolí jako platnou hodnotu prázdný řetězec.
shiftStep number O kolik se hodnota zvýší při podržení klávesy SHIFT. Tato hodnota je násobitelem kroku. Například pokud je krok 5 a shiftStep je 10, každé zvýšení nebo snížení bude o 50.
step number O kolik se hodnota změní při jejím zvyšování nebo snižování. Jde také o faktor při ověřování, protože hodnota musí být násobkem kroku (s posunem o min, pokud je zadáno), aby byla platná. Přijímá zvláštní řetězcovou hodnotu any, která ruší omezení ověřování a způsobí, že se hodnota při každém zvýšení nebo snížení změní o 1.

přepínač

Vykreslí sadu přepínačů.

JSON
{
  "type": "radio",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Vlastnosti

Vlastnost Typ Popis
default string | number Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string | number Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
options array Možnosti, ze kterých lze vybírat.
returnFormat string Určuje formát vrácené hodnoty.
populate object
display string Nastavte na buttonGroup, chcete-li možnosti zobrazit jako skupinu tlačítek místo přepínačů.
allowNull boolean Umožňuje uživateli vymazat hodnotu opětovným kliknutím na vybraný přepínač.

rozsah

Vykreslí vstupní posuvník pro nastavení číselné hodnoty mezi dvěma body.

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

Vlastnosti

Vlastnost Typ Popis
default number Výchozí hodnota, která se použije při prvním přidání bloku.
fallback number Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
allowReset boolean Je-li tato vlastnost true, vykreslí se tlačítko pro resetování posuvníku.
initialPosition number Výchozí pozice posuvníku použitá, pokud není předána žádná hodnota. initialPosition bude omezena na rozsah hodnot vlastností min a max.
isShiftStepEnabled boolean Je-li hodnota true, umožní gestem tažení myší zvýšit nebo snížit číselnou hodnotu. Podržením klávesy SHIFT při tažení se hodnota zvýší o shiftStep.
marks array Vykreslí vizuální znázornění značek kroků. Vlastní značky lze zadat jako pole.
max number Maximální délka hodnoty.
min number Minimální délka hodnoty.
railColor string CSS barevný řetězec pro přizpůsobení pozadí lišty.
resetFallbackValue number Hodnota, na kterou se přejde po kliknutí na tlačítko Reset (povoleno pomocí allowReset).
separatorType string Určuje, zda má být oddělovací čára pod nebo nad řádkem ovládacího prvku skrytá, nebo přes celou šířku. Ve výchozím nastavení je umístěna pod řádkem a nekryje ikonu ovládacího prvku.
shiftStep number O kolik se hodnota zvýší při podržení klávesy SHIFT. Tato hodnota je násobitelem kroku. Například pokud je krok 5 a shiftStep je 10, každé zvýšení nebo snížení bude o 50.
showTooltip boolean Vynutí zobrazení nebo skrytí popisku s nápovědou UI. Pokud je krok nastaven na zvláštní řetězcovou hodnotu any, tato vlastnost se nastaví na false.
step number O kolik se hodnota změní při jejím zvyšování nebo snižování. Jde také o faktor při ověřování, protože hodnota musí být násobkem kroku (s posunem o min, pokud je zadáno), aby byla platná. Přijímá zvláštní řetězcovou hodnotu any, která ruší omezení ověřování a způsobí, že se hodnota při každém zvýšení nebo snížení změní o 1.
trackColor string CSS barevný řetězec pro přizpůsobení pozadí dráhy.
withInputField boolean Určuje, zda se vedle RangeControl zobrazí číselné vstupní pole. Pokud je krok nastaven na zvláštní řetězcovou hodnotu any, tato vlastnost se nastaví na false.

výběr

Vykreslí vstupní pole pro výběr s podporou výběru jedné nebo více možností.

JSON
{
  "type": "select",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ],
  "multiple": false
}

Vlastnosti

Vlastnost Typ Popis
default array | string | number Výchozí hodnota, která se použije při prvním přidání bloku.
fallback array | string | number Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
multiple boolean Je-li hodnota true, lze vybrat více možností. „stylisedUi“ se zapne automaticky.
options array Možnosti, ze kterých lze vybírat.
returnFormat string Určuje formát vrácené hodnoty.
populate object
stylisedUi boolean Vykreslí stylizovanou variantu výběru, ve které lze položky vyhledávat.
allowNull boolean | string Umožňuje uživateli vybrat prázdnou možnost. Je-li hodnota true, bude popisek prázdný, jinak se u možnosti zobrazí zadaný řetězec.
allowReset boolean Je-li tato vlastnost true, vykreslí se tlačítko pro resetování výběru.

karty

Vykreslí rozhraní s kartami pro seskupení polí.

JSON
{
  "type": "tabs"
}

Vlastnosti

Vlastnost Typ Popis
tabs array Karty, které se mají zobrazit.

text

Vykreslí jednořádkové textové pole.

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

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
max number Maximální délka hodnoty.
min number Minimální délka hodnoty.

textové pole

Vykreslí textové pole.

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

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
max number Maximální délka hodnoty.
min number Minimální délka hodnoty.
rows number Počet řádků, které má textové pole obsahovat.

přepínač

Vykreslí přepínač true/false.

JSON
{
  "type": "toggle"
}

Vlastnosti

Vlastnost Typ Popis
default boolean Výchozí hodnota, která se použije při prvním přidání bloku.
fallback boolean Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.

opakovač

Vykreslí sadu polí, která lze opakovat.

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

Vlastnosti

Vlastnost Typ Popis
default array Řádky, se kterými se nový blok vytvoří. Každý řádek je objekt s hodnotami polí. Má přednost před řádky vytvořenými pomocí min.
min number Minimální počet řádků.
max number Maximální počet řádků.
minimized boolean Při otevření editoru sbalí existující řádky. Řádky přidané v editoru jsou zpočátku rozbalené.
textButton string Text tlačítka pro přidání.
textMinimized string | object Text, který se zobrazí při minimalizaci řádků.
textRemove string | boolean Potvrzovací otázka zobrazená v editoru při odebírání řádku opakovače. Neprázdný řetězec změní otázku; hodnota false odebere řádek okamžitě bez dialogu. Pokud tuto možnost vynecháte, nastavíte na true nebo na prázdný řetězec, použije se výchozí otázka.
attributes array Přijímá všechny ostatní typy polí kromě dalšího pole tabs.

richtext

Atributové pole pro pole RichText.

JSON
{
  "type": "richtext"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota použitá při prvním přidání bloku.
fallback string Záložní hodnota zobrazená, když je hodnota pole prázdná.

unit

Vykreslí číselné pole s rozbalovací nabídkou jednotek.

JSON
{
  "type": "unit"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota použitá při prvním přidání bloku.
fallback string Záložní hodnota zobrazená, když je hodnota pole prázdná.
disableUnits boolean Je-li hodnota true, výběr jednotky se skryje.
isPressEnterToChange boolean Je-li hodnota true, ke spuštění události onChange je nutné stisknout klávesu ENTER. Změna se vyvolá také při odchodu klávesou Tab.
isResetValueOnUnitChange boolean Je-li hodnota true a vybraná jednotka má výchozí hodnotu, při změně jednotek se nastaví tato hodnota.
isUnitSelectTabbable boolean Určuje, zda lze na výběr jednotky přejít klávesou Tab.
units array

wysiwyg

Vykreslí editor WYSIWYG.

JSON
{
  "type": "wysiwyg"
}

Vlastnosti

Vlastnost Typ Popis
default string Výchozí hodnota, která se použije při prvním přidání bloku.
fallback string Záložní hodnota, která se zobrazí, když je hodnota pole prázdná.
toolbar object Konfigurace panelu nástrojů editoru.
mode string code otevře pole v zobrazení kódu. both přidá tlačítko pro přepínání mezi vizuálním zobrazením a zobrazením kódu.

Načítání ikon

Editor načte sadu ikon, když poprvé otevřete její výběr nebo změníte sadu či podmnožinu, nikoli při výběru bloku. Pole, která požadují stejnou sadu, sdílejí probíhající požadavek. Uložený název ikony zůstane viditelný i před načtením a při opětovném otevření výběru se neúspěšný požadavek zopakuje.

tabler-icons podporuje outline a filled. Podmnožina výslovně nakonfigurovaná pro zvolenou sadu má přednost; jinak výběr použije solid, pokud je k dispozici, nebo první podmnožinu sady. U sad bez podmnožin se subSet neuvádí. Názvy sad odpovídají pouze souborům přibaleným k aplikaci. Vykreslování na frontendu ukládá do mezipaměti jednotlivé ikony, nikoli celé sady ikon v přechodných záznamech databáze.

Importované hodnoty možností

Zaškrtávací políčka a výběrová pole s "multiple": true obvykle ukládají pole objektů { "value": "...", "label": "..." }. Přijímají také jeden objekt možnosti, řetězec nebo číslo jako skalární hodnotu či pole skalárních hodnot importovaných prostřednictvím REST API nebo nástrojů pro správu obsahu. Funguje to také uvnitř řádků opakovače.

Editor zobrazuje tyto hodnoty jako vybrané možnosti, aniž by při uložení beze změn přepisoval jejich uloženou podobu. Přidáním nebo odebráním výběru se uloží obvyklé pole objektů možností. Číselné 0 a řetězcové "0" představují platné výběry. Šablony obdrží nakonfigurovanou hodnotu returnFormat pole stejně jako u hodnot vybraných v editoru. Možnosti musí stále odpovídat deklarovaným nebo naplněným volbám pole.

Nativní pole pro výběr jedné možnosti bez uložené nebo výchozí hodnoty zobrazuje zakázaný prázdný zástupný text, nikoli první možnost. Výběrem první možnosti ji výslovně uložíte. Jakmile je volba uložena, zástupný text zmizí. Použijte allowNull, pokud mají mít možnost výběr také vymazat. Prázdný zástupný text neumožňuje vymazat jinak povinnou volbu.

Počáteční řádky opakovače

V editoru zahrnují výchozí hodnoty před vložením také vnořené minimální řádky. Nemusíte je inicializovat otevřením nastavení bloku a vložení bloku pro tyto řádky nepřidá druhý krok zpět.

Pokud má opakovač min, ale nemá uloženou hodnotu ani výslovné default, server inicializuje tolik řádků, kolik určuje tato hodnota, a použije výchozí hodnoty polí v řádcích. Platí to také pro vložený obsah PHP, značky bloků a zdrojové soubory stránek, které ještě nebyly otevřeny v editoru. Například "min": 2 s textovým polem, jehož výchozí hodnota je "New item", vykreslí dva řádky obsahující tuto hodnotu.

Uložené řádky a výslovné default opakovače mají přednost. Výslovně uložený prázdný seznam, false nebo null znovu nevytvoří odebrané řádky. Vykreslení tyto vygenerované výchozí hodnoty do příspěvku neukládá. min a max omezují ovládací prvky editoru; při vykreslení nezkracují ani nedoplňují uložený seznam. Pomocí bs_validate_block() nahlaste porušení limitů řádků v importovaném obsahu.

Pole řádků bez default jsou ve vygenerovaném řádku false, takže takový řádek nemá žádný obsah. Stejně vypadají řádky, které editoři přidají a ponechají prázdné. Šablona, která pro každý řádek vypisuje kartu, nadpis nebo položku seznamu, by měla mimo editor řádky bez obsahu přeskočit a v editoru je ponechat, aby jejich pole zůstala upravitelná:

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

Odebrání opakovače

Při odebrání řádku se otevře potvrzovací dialog editoru s tlačítky Odstranit a Zrušit. Volba Zrušit nebo stisk klávesy Escape ponechá řádek beze změny. Řádek se odebere až po potvrzení, a to i u vnořených opakovačů.

textRemove řídí stejné chování u všech opakovačů:

Hodnota Chování
Neuvedeno, true nebo "" Zobrazí výchozí potvrzovací otázku.
Neprázdný řetězec Zobrazí vlastní otázku s využitím stávajícího mechanismu překladu vlastního textu.
false Odebere řádek okamžitě bez dialogu.

Například "textRemove": "Remove this team member?" změní otázku. Stávající omezení min stále brání odebrání řádků pod minimálním počtem.

Vnořování opakovačů

Řádek opakovače přijímá všechny typy polí kromě tabs. Pole tabs v řádku, také uvnitř skupiny bez id, zobrazí v editoru upozornění místo svých polí. Rozšíření PHPStan na to upozorní u block.json a field.json. Pole řádku ponechte na jedné úrovni nebo přesuňte karty mimo opakovač.

Panel nástrojů odkazů WYSIWYG vkládá odkazy, které se otevírají na stejné kartě, a ve výchozím nastavení nepřidává target ani rel. Možnost otevření na nové kartě zapnete pomocí toolbar.formats.link.opensInNewTab:

JSON
{
  "id": "content",
  "type": "wysiwyg",
  "toolbar": {
    "formats": {
      "link": {
        "opensInNewTab": true
      }
    }
  }
}

Při výběru nové karty se přidají target="_blank" a rel="noreferrer noopener". Po vypnutí se tyto automatické atributy odeberou. Chcete-li použít atributy u všech odkazů v daném poli, nastavte toolbar.formats.link.attributes, například { "class": "content-link", "rel": "nofollow" }. Výslovná konfigurace zůstane zachována a do nakonfigurovaného rel se přidají bezpečnostní tokeny pro novou kartu.

Zadáním URL se odkaz automaticky nevytvoří a kliknutí na existující odkaz v poli vás z editoru nepřesměruje. Atributy dříve uložených odkazů zůstávají ve stávajícím obsahu; automaticky se nemigrují.