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}.
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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ů.
{
"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.
{
"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. |
odkaz
Vykreslí ovládací prvek pro výběr interních nebo externích odkazů.
{
"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.
{
"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.
{
"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čů.
{
"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.
{
"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í.
{
"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í.
{
"type": "tabs"
}
Vlastnosti
| Vlastnost | Typ | Popis |
|---|---|---|
tabs |
array |
Karty, které se mají zobrazit. |
text
Vykreslí jednořádkové textové pole.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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 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č.
Odkazy WYSIWYG
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:
{
"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í.