Preskočiť na obsah

Typy polí

Blockstudio ponúka rôzne typy polí na vytváranie rozhraní blokov.

Projekty môžu zaregistrovať aj vlastné typy polí s menným priestorom pomocou blockstudio/field_types. Použite ich, keď potrebujete nový ovládací prvok editora alebo štruktúrovaný tvar hodnoty. Ak potrebujete iba opätovne použiť skupinu existujúcich polí, použite polia custom/{name}.

Kuchárka vzorov polí

Praktické návody: podmienené skupiny, inteligentné výbery, opakovače a úložisko s podporou dopytov.

Všeobecné vlastnosti

Nasledujúca tabuľka uvádza spoločné vlastnosti a bežné možnosti hodnôt. default a fallback sú podporované tam, kde sú uvedené v tabuľke vlastností každého typu poľa.

Vlastnosť Typ Popis
id string Jedinečný identifikátor atribútu
type string Typ poľa
label string Zobrazovaný štítok v editore
description string Text popisu zobrazený pod poľom
default mixed Predvolená hodnota poľa
fallback mixed Náhradná hodnota, keď je pole prázdne
help string Text pomocníka zobrazený ako tip vedľa štítka
hidden boolean Skryť pole z UI
switch boolean Zobraziť prepínač, ktorým možno pole deaktivovať. Predvolená hodnota je false.
translate boolean Nastavením na false sa pole vynechá z konfigurácie WPML
conditions array Pravidlá podmienenej logiky

Polia typu súbor s "returnFormat": "id" zachovávajú importované reťazcové odkazy, vrátane samostatných hodnôt v opakovačoch. Nevyriešené názvy zobrazujú náhradné karty bez miniatúr; Blockstudio ich neprevedie na ID príloh. Podrobnosti nájdete v časti prenosné odkazy na médiá.

Požiadavky na výber, opakovania a podmnožiny ikon nájdete v časti Načítanie ikon.

attributes

Vykresľuje vstupné polia atribútov dát.

JSON
{
  "type": "attributes"
}

Vlastnosti

Vlastnosť Typ Opis
default array Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback array Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
link boolean Umožňuje vybrať odkaz z rozbaľovacieho zoznamu.
media boolean Umožňuje vybrať médium z rozbaľovacieho zoznamu.

block

Odkazuje na ďalší blok Blockstudio a zobrazuje jeho polia priamo v riadku. V šablónach vráti hodnotu vykresleného výstupu bloku.

JSON
{
  "type": "block"
}

Vlastnosti

Vlastnosť Typ Opis
block string Názov bloku, na ktorý sa má odkazovať (e.g., "mytheme/card").
returnFormat string Určuje, ako sa má hodnota vrátiť v šablónach.

checkbox

Vykreslí skupinu začiarkavacích políčok.

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

Vlastnosti

Vlastnosť Typ Popis
default array | string | number Predvolená hodnota, ktorá sa má použiť pri prvom pridaní bloku.
fallback array | string | number Náhradná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
options array Možnosti, z ktorých možno vyberať.
returnFormat string Určuje formát vrátenej hodnoty.
populate object
toggle boolean | string Pridá nad možnosti začiarkavacie políčko, ktorým možno vybrať alebo zrušiť výber všetkých možností. Ako jeho štítok sa použije reťazec; pri hodnote true sa použije predvolený štítok.

classes

Vykreslí pole na výber tried CSS.

JSON
{
  "type": "classes"
}

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
tailwind boolean Určuje, či sa pre toto vstupné pole majú povoliť triedy Tailwind.

code

Vykreslí editor kódu.

JSON
{
  "type": "code"
}

Vlastnosti

Vlastnosť Typ Popis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
autoCompletion boolean Či sa má povoliť automatické dopĺňanie.
foldGutter boolean Či sa má zobrazovať okraj na zbaľovanie kódu.
height string Výška editora.
language string Jazyk používaný na zvýrazňovanie syntaxe.
lineNumbers boolean Či sa majú zobrazovať čísla riadkov.
maxHeight string Maximálna výška editora.
minHeight string Minimálna výška editora.
popout boolean Či sa má zobrazovať tlačidlo, ktoré otvorí editor vo vyskakovacom okne.
asset boolean Vykreslí CSS, SCSS alebo JavaScript z poľa ako prostriedok bloku, takže šablóna nemusí vypisovať značku style ani script.

color

Vykreslí paletu farieb a výber farby.

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

Vlastnosti

Vlastnosť Typ Popis
default string Hodnota možnosti, ktorá sa vyberie pri prvom pridaní bloku.
fallback string Hodnota možnosti, ktorá sa zobrazí, keď je hodnota poľa prázdna.
options array
populate object
clearable boolean Či má paleta obsahovať tlačidlo na vymazanie výberu.
disableCustomColors boolean Či sa má povoliť vlastná farba.

date

Vykreslí výber dátumu.

JSON
{
  "type": "date"
}

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
startOfWeek number Deň, ktorým sa má začínať týždeň. 0 znamená nedeľu, 1 pondelok atď.

datetime

Vykreslí výber dátumu a času.

JSON
{
  "type": "datetime"
}

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
is12Hour boolean Určuje, či sa používa 12-hodinový formát času. Pri 12-hodinovom formáte sa zobrazí prvok AM/PM a predpokladá sa formát času MM-DD-YYYY (na rozdiel od predvoleného formátu DD-MM-YYYY).

files

Vykreslí tlačidlo na otvorenie knižnice médií. Vybrané položky možno zoradiť priamo v riadku.

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

Vlastnosti

Vlastnosť Typ Opis
default array | object | number Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback array | object | number Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
addToGallery boolean Ak je hodnota true, okno galérie médií sa otvorí priamo v knižnici médií, kde môže používateľ pridať ďalšie obrázky. Ak je hodnota false, okno galérie médií sa otvorí v režime úprav, v ktorom môže používateľ upravovať existujúce obrázky ich zmenou poradia, odstránením alebo zmenou ich atribútov. Platí iba vtedy, keď gallery === true.
allowedTypes array | string Pole typov médií, ktoré možno nahrať alebo vybrať z knižnice médií. Každý typ je reťazec, ktorý môže obsahovať všeobecný typ MIME e.g: ‘image’, ‘audio’, ‘text’ alebo úplný typ MIME e.g: ‘audio/mpeg’, ‘image/gif’. Ak nie je nastavené allowedTypes, povolia sa všetky typy MIME.
gallery boolean Ak je hodnota true, komponent nastaví všetky stavy potrebné na zobrazenie galérie. Predvolene sa okno médií otvorí v ráme na úpravu galérie, no pomocou príznaku addToGalleryflag možno toto správanie zmeniť.
max number Maximálny počet súborov, ktoré možno pridať.
min number Minimálny počet súborov, ktoré možno pridať.
multiple boolean Určuje, či možno vybrať viac položiek.
size boolean Pridá do poľa rozbaľovací zoznam veľkostí médií.
textMediaButton string Text tlačidla médií.
title string Názov zobrazený v okne médií.
returnFormat string Určuje formát vrátenej hodnoty.
returnSize string Veľkosť média, ktorá sa vráti pri použití formátu návratovej hodnoty URL.

gradient

Vykreslí paletu prechodov a výber prechodu.

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

Vlastnosti

Vlastnosť Typ Popis
default string Hodnota možnosti, ktorá sa vyberie pri prvom pridaní bloku.
fallback string Hodnota možnosti, ktorá sa zobrazí, keď je hodnota poľa prázdna.
options array
populate object
clearable boolean Či má paleta obsahovať tlačidlo na vymazanie výberu.
disableCustomGradients boolean Či sa má povoliť vlastná farba.

group

Vykreslí viacero polí v rozbaľovacom (voliteľne) kontajneri.

JSON
{
  "type": "group"
}

Vlastnosti

Vlastnosť Typ Opis
title string Text nadpisu. Zobrazuje sa aj vtedy, keď je komponent zatvorený.
opened boolean Ak je nastavená hodnota true, komponent zostane otvorený bez ohľadu na vlastnosť initialOpen a
initialOpen boolean Určuje, či bude panel po otvorení predvolene rozbalený.
scrollAfterOpen boolean Keď sa obsah zobrazí, posunie ho do viditeľnej oblasti.
class string Vlastná trieda CSS, ktorá sa použije na skupinu.
style object Vlastné štýly CSS, ktoré sa použijú na skupinu.
attributes array Prijíma všetky ostatné typy polí okrem ďalších kariet.

html-tag

Vykreslí výber značky HTML. Hodí sa na výber úrovní nadpisov alebo sémantických prvkov.

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

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
tags string | array Ktoré značky zahrnúť. Použite prednastavený reťazec alebo pole názvov značiek.
exclude array Značky, ktoré sa majú vylúčiť z prednastavenej množiny. Platí iba pri použití prednastaveného reťazca pre značky.

icon

Vykreslí ikonu SVG zo sady ikon.

JSON
{
  "type": "icon"
}

Vlastnosti

Vlastnosť Typ Opis
default object Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback object Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
sets array | string Ktorú sadu ikon zahrnúť. Ak chcete zahrnúť všetky, nechajte pole prázdne.
subSets array | string Ktorú podmnožinu ikon zahrnúť. Ak chcete zahrnúť všetky, nechajte pole prázdne.
returnFormat string Formát, v ktorom sa má ikona vrátiť.

Vykreslí ovládací prvok na výber interných alebo externých odkazov.

JSON
{
  "type": "link"
}

Vlastnosti

Vlastnosť Typ Opis
default object Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback object Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
hasRichPreviews boolean Určuje, či sa pri pridávaní URL majú zobrazovať rozšírené ukážky.
noDirectEntry boolean Určuje, či možno vyhľadávací dopyt podobný URL priamo zmeniť na odkaz.
noURLSuggestion boolean Určuje, či sa má pridať záložný návrh, ktorý považuje vyhľadávací dopyt za URL.
opensInNewTab boolean Pridá do okna odkazu prepínač.
showSuggestions boolean Určuje, či sa pri zadávaní URL majú zobrazovať návrhy.
textButton string Vlastný text, ktorý sa zobrazí vo vnútri tlačidla odkazu.
withCreateSuggestion boolean Určuje, či sa pri vyhľadávaní odkazu bez zhody môže vytvoriť návrh novej konceptnej stránky.

message

Vykreslí správu s vlastným obsahom.

JSON
{
  "type": "message"
}

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
value string Správa, ktorá sa má zobraziť. Údaje o bloku a atribútoch sú dostupné v hranatej notácii, e.g.: {block.title} alebo {attributes.text}

number

Vykreslí číselné vstupné pole.

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

Vlastnosti

Vlastnosť Typ Opis
default number Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback number Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
dragDirection string Určuje os ťahania na zvýšenie alebo zníženie hodnoty.
dragThreshold number Ak je hodnota isDragEnabled true, určuje počet pixelov, o ktoré treba potiahnuť, aby sa hodnota zmenila.
hideHTMLArrows boolean Ak je hodnota true, skryjú sa predvolené šípky HTML vstupného poľa.
isShiftStepEnabled boolean Ak je hodnota true, povolí gesto ťahania myšou na zvýšenie alebo zníženie číselnej hodnoty. Podržaním klávesu SHIFT počas ťahania sa hodnota zvýši o shiftStep.
max number Maximálna dĺžka hodnoty.
min number Minimálna dĺžka hodnoty.
required boolean Ak je hodnota true, vynúti platné číslo v rozsahu min/max ovládacieho prvku. Ak je hodnota false, prázdny reťazec sa povolí ako platná hodnota.
shiftStep number O koľko sa hodnota zvýši pri podržaní klávesu SHIFT. Táto hodnota je násobiteľom kroku. Napríklad ak je krok 5 a shiftStep je 10, pri každom skoku sa hodnota zvýši alebo zníži o 50.
step number O koľko sa hodnota zmení pri jej zvyšovaní alebo znižovaní. Používa sa aj pri overovaní, pretože platná hodnota musí byť násobkom kroku (s posunom o min, ak je zadané). Akceptuje špeciálnu reťazcovú hodnotu any, ktorá ruší obmedzenie overovania a spôsobí, že sa pri zvyšovaní alebo znižovaní hodnota mení po 1.

radio

Vykreslí skupinu prepínačov.

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

Vlastnosti

Vlastnosť Typ Popis
default string | number Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string | number Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
options array Možnosti, z ktorých si možno vybrať.
returnFormat string Určuje formát návratovej hodnoty.
populate object
display string Nastavte na buttonGroup, ak chcete zobraziť možnosti ako skupinu tlačidiel namiesto prepínačov.
allowNull boolean Umožňuje používateľovi vymazať hodnotu opätovným kliknutím na vybraný prepínač.

range

Vykreslí posuvník na nastavenie číselnej hodnoty medzi dvoma bodmi.

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

Vlastnosti

Vlastnosť Typ Opis
default number Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback number Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
allowReset boolean Ak je táto vlastnosť true, zobrazí sa tlačidlo na obnovenie posuvníka.
initialPosition number Počiatočná poloha posuvníka použitá, keď nie je zadaná hodnota. Hodnota initialPosition sa ohraničí zadanými hodnotami vlastností min a max.
isShiftStepEnabled boolean Ak je hodnota true, povolí gesto ťahania myšou na zvýšenie alebo zníženie číselnej hodnoty. Podržaním klávesu SHIFT počas ťahania sa hodnota zvýši o shiftStep.
marks array Vykreslí vizuálne značky jednotlivých krokov. Vlastné značky možno zadať ako pole.
max number Maximálna dĺžka hodnoty.
min number Minimálna dĺžka hodnoty.
railColor string Farebný reťazec CSS na prispôsobenie pozadia koľajnice.
resetFallbackValue number Hodnota, na ktorú sa obnoví nastavenie po kliknutí na tlačidlo Obnoviť (povolené pomocou allowReset).
separatorType string Určuje, či sa má oddeľovacia čiara pod/nad riadkom ovládacieho prvku vypnúť alebo roztiahnuť na celú šírku. Predvolene sa umiestňuje pod riadok a neprechádza pod ikonou ovládacieho prvku.
shiftStep number O koľko sa hodnota zvýši pri podržaní klávesu SHIFT. Táto hodnota je násobiteľom kroku. Napríklad ak je krok 5 a shiftStep je 10, pri každom skoku sa hodnota zvýši alebo zníži o 50.
showTooltip boolean Vynúti zobrazenie alebo skrytie UI obrázkovej bubliny s nápovedou. Ak je step nastavený na špeciálnu reťazcovú hodnotu any, táto možnosť sa prepíše na false.
step number O koľko sa hodnota zmení pri jej zvyšovaní alebo znižovaní. Používa sa aj pri overovaní, pretože platná hodnota musí byť násobkom kroku (s posunom o min, ak je zadané). Akceptuje špeciálnu reťazcovú hodnotu any, ktorá ruší obmedzenie overovania a spôsobí, že sa pri zvyšovaní alebo znižovaní hodnota mení po 1.
trackColor string Farebný reťazec CSS na prispôsobenie pozadia dráhy.
withInputField boolean Určuje, či sa má vedľa RangeControl zobraziť číselné vstupné pole. Ak je step nastavený na špeciálnu reťazcovú hodnotu any, táto možnosť sa prepíše na false.

select

Vykreslí vstupné pole select s podporou výberu jednej alebo viacerých možností.

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

Vlastnosti

Vlastnosť Typ Opis
default array | string | number Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback array | string | number Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
multiple boolean Ak je hodnota true, možno vybrať viacero možností. Automaticky sa povolí „stylisedUi“.
options array Možnosti, z ktorých možno vyberať.
returnFormat string Určuje formát vrátenej hodnoty.
populate object
stylisedUi boolean Vykreslí štylizovanú verziu výberového poľa, v ktorej možno vyhľadávať položky.
allowNull boolean | string Umožňuje používateľovi vybrať prázdnu možnosť. Ak je hodnota true, označenie bude prázdne; inak sa pri možnosti zobrazí zadaný reťazec.
allowReset boolean Ak je táto vlastnosť true, zobrazí sa tlačidlo na obnovenie výberu.

tabs

Vykreslí rozhranie s kartami na zoskupenie polí.

JSON
{
  "type": "tabs"
}

Vlastnosti

Vlastnosť Typ Opis
tabs array Karty, ktoré sa majú zobraziť.

text

Vykreslí jednoriadkové textové vstupné pole.

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

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
max number Maximálna dĺžka hodnoty.
min number Minimálna dĺžka hodnoty.

textarea

Vykreslí viacriadkové textové vstupné pole.

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

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
max number Maximálna dĺžka hodnoty.
min number Minimálna dĺžka hodnoty.
rows number Počet riadkov, ktoré má textové pole obsahovať.

toggle

Vykreslí prepínač hodnoty true/false.

JSON
{
  "type": "toggle"
}

Vlastnosti

Vlastnosť Typ Opis
default boolean Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback boolean Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.

repeater

Vykreslí množinu polí, ktoré možno opakovať.

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

Vlastnosti

Vlastnosť Typ Popis
default array Riadky, s ktorými sa začne nový blok. Každý riadok je objektom hodnôt polí. Majú prednosť pred počtom riadkov vytvoreným nastavením min.
min number Minimálny počet riadkov.
max number Maximálny počet riadkov.
minimized boolean Pri otvorení editora zbaľte existujúce riadky. Riadky pridané v editore sa zobrazia rozbalené.
textButton string Text tlačidla na pridanie.
textMinimized string | object Text, ktorý sa zobrazí pri zbalených riadkoch.
textRemove string | boolean Potvrdzovacia otázka zobrazená v editore pri odstraňovaní riadka opakovacieho poľa. Neprázdny reťazec zmení otázku; hodnota false odstráni riadok okamžite bez dialógového okna. Ak túto hodnotu vynecháte, nastavíte na true alebo zadáte prázdny reťazec, použije sa predvolená otázka.
attributes array Prijíma všetky ostatné typy polí okrem ďalšieho poľa kariet.

richtext

Atribútové pole pre polia RichText.

JSON
{
  "type": "richtext"
}

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota zobrazená, keď je hodnota poľa prázdna.

unit

Vykreslí číselné vstupné pole s rozbaľovacím zoznamom jednotiek.

JSON
{
  "type": "unit"
}

Vlastnosti

Vlastnosť Typ Opis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota zobrazená, keď je hodnota poľa prázdna.
disableUnits boolean Ak je hodnota true, pole na výber jednotky sa skryje.
isPressEnterToChange boolean Ak je hodnota true, na spustenie udalosti onChange treba stlačiť kláves ENTER. Pri zapnutí sa zmena spustí aj pri odchode z poľa pomocou klávesu Tab.
isResetValueOnUnitChange boolean Ak je hodnota true a vybraná jednotka má predvolenú hodnotu, táto hodnota sa nastaví pri zmene jednotiek.
isUnitSelectTabbable boolean Určuje, či možno do poľa na výber jednotky prejsť klávesom Tab.
units array

wysiwyg

Vykreslí editor WYSIWYG.

JSON
{
  "type": "wysiwyg"
}

Vlastnosti

Vlastnosť Typ Popis
default string Predvolená hodnota, ktorá sa použije pri prvom pridaní bloku.
fallback string Záložná hodnota, ktorá sa zobrazí, keď je hodnota poľa prázdna.
toolbar object Konfigurácia panela nástrojov editora.
mode string code otvorí pole v zobrazení kódu. both pridá tlačidlo na prepínanie medzi vizuálnym zobrazením a zobrazením kódu.

Načítanie ikon

Editor načíta súpravu ikon pri prvom zameraní výberu ikon alebo pri zmene súpravy či podskupiny, nie pri výbere bloku. Polia, ktoré požadujú rovnakú súpravu, zdieľajú práve prebiehajúcu požiadavku. Uložený názov ikony zostáva viditeľný aj pred načítaním a opätovné zameranie výberu zopakuje neúspešnú požiadavku.

tabler-icons podporuje outline a filled. Podskupina výslovne nakonfigurovaná pre vybranú súpravu má prednosť; inak výber používa solid, ak je k dispozícii, alebo prvú podskupinu súpravy. Súpravy bez podskupín neobsahujú subSet. Názvy súprav sa rozpoznávajú iba ako názvy pribalených súborov. Vykresľovanie na frontende ukladá do vyrovnávacej pamäte jednotlivé ikony, nie celé súpravy ikon v dočasných databázových záznamoch.

Importované hodnoty možností

Zaškrtávacie políčka a výberové zoznamy s "multiple": true zvyčajne ukladajú pole objektov { "value": "...", "label": "..." }. Prijímajú aj jeden objekt možnosti, skalárny reťazec alebo číslo, prípadne pole skalárnych hodnôt importovaných cez REST API alebo nástroje na správu obsahu. Funguje to aj v riadkoch opakovacieho poľa.

Editor zobrazuje tieto hodnoty ako výbery bez toho, aby pri uložení nezmeneného záznamu prepísal ich uloženú podobu. Pridaním alebo odstránením výberu sa uloží obvyklé pole objektov možností. Číselné 0 a textové "0" sú platné výbery. Šablóny dostávajú nakonfigurované returnFormat poľa, rovnako ako pri hodnotách vybraných v editore. Možnosti sa stále musia zhodovať s deklarovanými alebo naplnenými voľbami poľa.

Natívny jednoduchý výber bez uloženej alebo predvolenej hodnoty zobrazuje zakázaný prázdny zástupný text, nie svoju prvú možnosť. Výslovným výberom prvej možnosti sa táto možnosť uloží. Po uložení výberu zástupný text zmizne. Použite allowNull, keď chcete editorom umožniť aj zrušenie výberu; prázdny zástupný text neumožňuje zrušiť výber, ak je inak povinný.

Úvodné riadky opakovacieho poľa

V editore predvolené hodnoty zahŕňajú vnorené minimálne riadky ešte pred vložením. Na ich inicializáciu nemusíte otvárať nastavenia bloku a vloženie bloku pre tieto riadky nepridá druhý krok späť.

Keď má opakovač min, ale nemá uloženú hodnotu ani explicitné default, server inicializuje príslušný počet riadkov pomocou predvolených hodnôt polí. Platí to aj pre vložené prvky PHP, značky blokov a zdroje stránok založené na súboroch, ktoré ešte nikdy neboli otvorené v editore. Napríklad "min": 2 s textovým poľom, ktorého predvolená hodnota je "New item", vykreslí dva riadky s touto hodnotou.

Uložené riadky a explicitné default opakovača majú prednosť. Explicitne uložený prázdny zoznam, false alebo null neobnoví odstránené riadky. Vykreslenie tieto vygenerované predvolené hodnoty nezapíše späť do príspevku. min a max obmedzujú ovládacie prvky editora; pri vykreslení neskracujú ani nedopĺňajú uložený zoznam. Na nahlasovanie porušení obmedzení počtu riadkov v importovanom obsahu použite bs_validate_block().

Polia riadka bez default sú vo vygenerovanom riadku false, takže takýto riadok nemá žiadny obsah. Riadky, ktoré editori pridajú a nechajú prázdne, vyzerajú rovnako. Šablóna, ktorá pre každý riadok vypisuje kartu, nadpis alebo položku zoznamu, by mala mimo editora preskočiť riadky bez obsahu a v editore ich ponechať, aby ich polia zostali upraviteľné:

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

Odstránenie opakovača

Odstránením riadka sa otvorí potvrdzovacie dialógové okno editora s tlačidlami Odstrániť a Zrušiť. Zrušením alebo stlačením klávesu Escape zostane riadok nezmenený. Riadok sa odstráni až po potvrdení, a to aj v rámci vnorených opakovačov.

textRemove riadi rovnaké správanie pre každý opakovač:

Hodnota Správanie
Vynechané, true alebo "" Zobrazí predvolenú otázku na potvrdenie.
Neprázdny reťazec Zobrazí vlastnú otázku s použitím existujúceho mechanizmu prekladu vlastného textu.
false Odstráni riadok okamžite bez dialógového okna.

Napríklad "textRemove": "Remove this team member?" zmení otázku. Existujúce obmedzenie min stále bráni odstráneniu riadkov pod minimálnym počtom.

Vnáranie opakovačov

Riadok opakovača prijíma všetky typy polí okrem tabs. Pole tabs v riadku, aj v skupine bez id, namiesto svojich polí zobrazí v editore upozornenie. Rozšírenie PHPStan v takom prípade zobrazí hlásenie pre block.json a field.json. Polia riadka ponechajte na jednej úrovni alebo presuňte karty mimo opakovača.

Panel nástrojov odkazov WYSIWYG štandardne vkladá odkazy otvárajúce sa na tej istej karte bez pridania atribútu target ani rel. Možnosť otvorenia na novej karte zapnete pomocou toolbar.formats.link.opensInNewTab:

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

Výberom novej karty sa pridajú target="_blank" a rel="noreferrer noopener". Vypnutím tejto možnosti sa tieto automatické atribúty odstránia. Ak chcete použiť atribúty na každý odkaz v danom poli, nastavte toolbar.formats.link.attributes, napríklad { "class": "content-link", "rel": "nofollow" }. Explicitná konfigurácia sa zachová a do nakonfigurovaného rel sa pridajú bezpečnostné tokeny na otvorenie na novej karte.

Zadanie URL ho automaticky nezmení na odkaz a kliknutím na existujúci odkaz v poli sa neprejde mimo editora. Atribúty odkazov uložené skôr zostanú v existujúcom obsahu; automaticky sa nemigrujú.