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}.
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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ť. |
link
Vykreslí ovládací prvok na výber interných alebo externých odkazov.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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í.
{
"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í.
{
"type": "tabs"
}
Vlastnosti
| Vlastnosť | Typ | Opis |
|---|---|---|
tabs |
array |
Karty, ktoré sa majú zobraziť. |
text
Vykreslí jednoriadkové textové vstupné pole.
{
"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.
{
"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.
{
"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ť.
{
"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.
{
"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.
{
"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.
{
"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 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.
Odkazy WYSIWYG
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:
{
"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ú.