Vrste polj
Blockstudio ponuja različne vrste polj za izdelavo vmesnikov blokov.
Projekti lahko registrirajo tudi lastne vrste polj z imenskim prostorom z uporabo blockstudio/field_types. To uporabite, kadar potrebujete nov kontrolnik urejevalnika ali strukturirano obliko vrednosti. Polja custom/{name} uporabite, kadar želite znova uporabiti samo skupino obstoječih polj.
Praktični recepti: pogojne skupine, pametni izbirniki, ponavljalniki in poizvedljivo shranjevanje.
Splošne lastnosti
Spodnja tabela navaja skupne lastnosti in običajne možnosti vrednosti. default in
fallback sta podprta tam, kjer sta navedena v tabeli lastnosti posamezne vrste polja.
| Lastnost | Vrsta | Opis |
|---|---|---|
id |
string | Enolični identifikator atributa |
type |
string | Vrsta polja |
label |
string | Oznaka, prikazana v urejevalniku |
description |
string | Besedilo opisa, prikazano pod poljem |
default |
mixed | Privzeta vrednost polja |
fallback |
mixed | Nadomestna vrednost, kadar je polje prazno |
help |
string | Besedilo pomoči, prikazano kot namig ob oznaki |
hidden |
boolean | Skrij polje v UI |
switch |
boolean | Prikaži preklop, s katerim je mogoče onemogočiti polje. Privzeta vrednost je false. |
translate |
boolean | Nastavite na false, da polje izpustite iz konfiguracije WPML |
conditions |
array | Pravila pogojne logike |
Polja za datoteke z "returnFormat": "id" ohranijo uvožene sklice na nize,
tudi posamezne vrednosti znotraj ponavljalnikov. Nerazrešena imena prikažejo nadomestne kartice
brez sličic; Blockstudio jih ne razreši v ID-je prilog. Podrobnosti najdete v razdelku
prenosni sklici na predstavnost.
Za zahteve izbirnika, ponovne poskuse in podmnožice ikon glejte Nalaganje ikon.
attributes
Izriše vnose atributov podatkov.
{
"type": "attributes"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
array |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
array |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
link |
boolean |
Omogoča izbiro povezave s spustnega seznama. |
media |
boolean |
Omogoča izbiro predstavnosti s spustnega seznama. |
blok
Sklicuje se na drug blok Blockstudio in njegova polja razširi v vrstici. V predlogah vrne vrednost upodobljenega izhoda bloka.
{
"type": "block"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
block |
string |
Ime bloka, na katerega se sklicuje (npr. e.g, »mytheme/card«). |
returnFormat |
string |
Način vračanja vrednosti v predlogah. |
potrditveno polje
Izriše nabor vnosnih polj s potrditvenimi polji.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
array | string | number |
Privzeta vrednost, ki naj se uporabi ob prvem dodajanju bloka. |
fallback |
array | string | number |
Nadomestna vrednost, prikazana, kadar je vrednost polja prazna. |
options |
array |
Možnosti, med katerimi lahko izbirate. |
returnFormat |
string |
Določa obliko vrnjene vrednosti. |
populate |
object |
|
toggle |
boolean | string |
Doda potrditveno polje nad možnostmi, s katerim jih lahko vse izberete ali počistite. Kot oznaka se uporabi niz, vrednost true pa uporabi privzeto oznako. |
razredi
Izriše polje za izbiro razredov CSS.
{
"type": "classes"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
tailwind |
boolean |
Določa, ali naj se za to vnosno polje omogočijo razredi Tailwind. |
koda
Izriše urejevalnik kode.
{
"type": "code"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
autoCompletion |
boolean |
Ali omogočiti samodokončanje. |
foldGutter |
boolean |
Ali prikazati rob za strnjevanje. |
height |
string |
Višina urejevalnika. |
language |
string |
Jezik za označevanje sintakse. |
lineNumbers |
boolean |
Ali prikazati številke vrstic. |
maxHeight |
string |
Največja višina urejevalnika. |
minHeight |
string |
Najmanjša višina urejevalnika. |
popout |
boolean |
Ali prikazati gumb za odprtje urejevalnika v pojavnem oknu. |
asset |
boolean |
Iz polja prikaže CSS, SCSS ali JavaScript kot sredstvo bloka, zato predloga ne potrebuje oznake za slog ali skript. |
barva
Izriše barvno paleto in izbirnik barv.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Vrednost možnosti, ki naj bo izbrana ob prvem dodajanju bloka. |
fallback |
string |
Vrednost možnosti, ki se prikaže, ko je vrednost polja prazna. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Ali naj ima paleta gumb za brisanje. |
disableCustomColors |
boolean |
Ali dovoliti barvo po meri. |
datum
Izriše izbirnik datuma.
{
"type": "date"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
startOfWeek |
number |
Dan, na katerega se začne teden. 0 pomeni nedeljo, 1 ponedeljek itd. |
datum in čas
Izriše izbirnik datuma in časa.
{
"type": "datetime"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
is12Hour |
boolean |
Določa, ali se uporablja 12-urni zapis časa. Pri 12-urnem zapisu je prikazan izbirnik AM/PM, predpostavljena oblika datuma in časa pa je MM-DD-YYYY (namesto privzete DD-MM-YYYY). |
datoteke
Izriše gumb za knjižnico predstavnosti. Izbrane elemente je mogoče prerazporediti v vrstici.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
array | object | number |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
array | object | number |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
addToGallery |
boolean |
Če je true, se modalno okno galerije predstavnosti odpre neposredno v knjižnici predstavnosti, kjer lahko uporabnik doda dodatne slike. Če je false, se modalno okno galerije predstavnosti odpre v načinu urejanja, kjer lahko uporabnik ureja obstoječe slike, jih prerazporedi, odstrani ali spremeni njihove atribute. Upošteva se samo, če je gallery === true. |
allowedTypes |
array | string |
Polje s tipi predstavnosti, ki jih je mogoče naložiti ali izbrati iz knjižnice predstavnosti. Vsak tip je niz, ki lahko vsebuje splošni tip MIME e.g: ‘image’, ‘audio’, ‘text’ ali celotni tip MIME e.g: ‘audio/mpeg’, ‘image/gif’. Če allowedTypes ni nastavljen, so dovoljeni vsi tipi MIME. |
gallery |
boolean |
Če je true, komponenta inicializira vsa stanja, potrebna za prikaz galerije. Modalno okno predstavnosti se privzeto odpre v okvirju za urejanje galerije, vendar je to mogoče spremeniti z zastavico addToGalleryflag. |
max |
number |
Največje število datotek, ki jih je mogoče dodati. |
min |
number |
Najmanjše število datotek, ki jih je mogoče dodati. |
multiple |
boolean |
Določa, ali je mogoče izbrati več elementov. |
size |
boolean |
Polju doda spustni seznam velikosti predstavnosti. |
textMediaButton |
string |
Besedilo gumba za predstavnost. |
title |
string |
Naslov, prikazan v modalnem oknu predstavnosti. |
returnFormat |
string |
Določa obliko vrnjene vrednosti. |
returnSize |
string |
Velikost predstavnosti, ki se vrne pri uporabi oblike vrnitve URL. |
preliv
Izriše paleto prelivov in izbirnik preliva
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Vrednost možnosti, ki naj bo izbrana ob prvem dodajanju bloka. |
fallback |
string |
Vrednost možnosti, ki se prikaže, ko je vrednost polja prazna. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Ali naj ima paleta gumb za brisanje. |
disableCustomGradients |
boolean |
Ali dovoliti barvo po meri. |
skupina
Izriše več polj v (po želji) zložljivem vsebniku.
{
"type": "group"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
title |
string |
Besedilo naslova. Prikazano je tudi, ko je komponenta zaprta. |
opened |
boolean |
Če je nastavljeno na true, bo komponenta ostala odprta ne glede na lastnost initialOpen in |
initialOpen |
boolean |
Določa, ali bo plošča ob začetku odprta. |
scrollAfterOpen |
boolean |
Ko je vsebina vidna, jo pomakne v vidno območje. |
class |
string |
Razred CSS po meri, ki bo uporabljen za skupino. |
style |
object |
Slogi CSS po meri, ki bodo uporabljeni za skupino. |
attributes |
array |
Sprejme vse druge vrste polj, razen zavihkov. |
oznaka HTML
Izriše izbirnik oznak HTML. Uporaben je za izbiro ravni naslovov ali semantičnih elementov.
{
"type": "html-tag"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
tags |
string | array |
Katere oznake vključiti. Uporabite prednastavljeni niz ali polje imen oznak. |
exclude |
array |
Oznake, ki jih želite izključiti iz prednastavitve. Uporablja se samo, če je za oznake uporabljen prednastavljeni niz. |
ikona
Izriše ikono SVG iz nabora ikon.
{
"type": "icon"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
object |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
object |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
sets |
array | string |
Kateri nabor ikon vključiti. Za vključitev vseh pustite prazno. |
subSets |
array | string |
Kateri podnabor ikon vključiti. Za vključitev vseh pustite prazno. |
returnFormat |
string |
Oblika vrnjene ikone. |
povezava
Izriše kontrolnik povezave za izbiro notranjih ali zunanjih povezav.
{
"type": "link"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
object |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
object |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
hasRichPreviews |
boolean |
Določa, ali naj bodo pri dodajanju elementa URL prikazani obogateni predogledi. |
noDirectEntry |
boolean |
Določa, ali je mogoče iskalno poizvedbo v slogu URL neposredno pretvoriti v povezavo. |
noURLSuggestion |
boolean |
Določa, ali naj se doda nadomestni predlog, ki iskalno poizvedbo obravnava kot URL. |
opensInNewTab |
boolean |
Modalnemu oknu povezave doda preklopni kontrolnik. |
showSuggestions |
boolean |
Določa, ali naj bodo med vnašanjem URL prikazani predlogi. |
textButton |
string |
Besedilo po meri, prikazano znotraj gumba za povezavo. |
withCreateSuggestion |
boolean |
Določa, ali lahko iskanja povezav brez zadetkov ustvarijo predlog nove osnutne strani. |
sporočilo
Izriše sporočilo z vsebino po meri.
{
"type": "message"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
value |
string |
Sporočilo za prikaz. Podatki bloka in atributov so na voljo v oglatem zapisu, e.g: {block.title} ali {attributes.text} |
število
Izriše vnosno polje za število.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
number |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
number |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
dragDirection |
string |
Določa os vlečenja za povečanje ali zmanjšanje vrednosti. |
dragThreshold |
number |
Če je isDragEnabled true, določa, koliko slikovnih pik je treba povleči, preden se vrednost spremeni. |
hideHTMLArrows |
boolean |
Če je true, skrije privzete puščice vnosnega polja HTML. |
isShiftStepEnabled |
boolean |
Če je true, omogoči povečanje ali zmanjšanje številske vrednosti z vlečenjem miške. Če med vlečenjem držite SHIFT, se vrednost poveča za shiftStep. |
max |
number |
Največja dolžina vrednosti. |
min |
number |
Najmanjša dolžina vrednosti. |
required |
boolean |
Če je true, zahteva veljavno število znotraj najmanjšega in največjega obsega kontrolnika. Če je false, dovoljuje prazen niz kot veljavno vrednost. |
shiftStep |
number |
Znesek povečanja ob držanju tipke SHIFT. Ta vrednost shift je množitelj vrednosti step. Če je na primer vrednost step 5 in shiftStep 10, se pri vsakem koraku vrednost poveča ali zmanjša za 50. |
step |
number |
Znesek spremembe vrednosti pri povečevanju ali zmanjševanju. Uporablja se tudi pri preverjanju veljavnosti, saj mora biti vrednost večkratnik step (s premikom za min, če je določen), da je veljavna. Sprejme posebno vrednost niza any, ki izniči omejitev preverjanja veljavnosti in povzroči, da se vrednost pri posameznem koraku poveča ali zmanjša za 1. |
izbirni gumb
Izriše nabor izbirnih gumbov.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string | number |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string | number |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
options |
array |
Možnosti, med katerimi lahko izbirate. |
returnFormat |
string |
Določa obliko vrnjene vrednosti. |
populate |
object |
|
display |
string |
Nastavite na buttonGroup, da se možnosti prikažejo kot skupina gumbov namesto izbirnih polj. |
allowNull |
boolean |
Uporabniku omogoča, da vrednost počisti s ponovnim klikom na izbrano izbirno polje. |
obseg
Izriše vnosno polje z drsnikom za nastavitev številske vrednosti med dvema točkama.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
number |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
number |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
allowReset |
boolean |
Če je ta lastnost true, se izriše gumb za ponastavitev drsnika. |
initialPosition |
number |
Začetni položaj drsnika, uporabljen, če vrednost ni podana. initialPosition je omejen na vrednosti min in max, podane z lastnostmi. |
isShiftStepEnabled |
boolean |
Če je true, omogoči povečanje ali zmanjšanje številske vrednosti z vlečenjem miške. Če med vlečenjem držite SHIFT, se vrednost poveča za shiftStep. |
marks |
array |
Izriše vizualni prikaz oznak korakov. Oznake po meri je mogoče podati kot Array. |
max |
number |
Največja dolžina vrednosti. |
min |
number |
Najmanjša dolžina vrednosti. |
railColor |
string |
Barvni niz CSS za prilagoditev ozadja elementa vodila. |
resetFallbackValue |
number |
Vrednost, na katero se vrne ob kliku gumba za ponastavitev (omogoči jo allowReset). |
separatorType |
string |
Določa, ali naj bo ločilna črta pod ali nad vrstico kontrolnika onemogočena ali naj sega čez celotno širino. Privzeto je pod vrstico, razen podčrtaja ikone kontrolnika. |
shiftStep |
number |
Znesek povečanja ob držanju tipke SHIFT. Ta vrednost shift je množitelj vrednosti step. Če je na primer vrednost step 5 in shiftStep 10, se pri vsakem koraku vrednost poveča ali zmanjša za 50. |
showTooltip |
boolean |
Uveljavi prikaz ali skrivanje namiga orodja UI. Če je step nastavljen na posebno vrednost niza any, se ta lastnost prepiše z vrednostjo false. |
step |
number |
Znesek spremembe vrednosti pri povečevanju ali zmanjševanju. Uporablja se tudi pri preverjanju veljavnosti, saj mora biti vrednost večkratnik step (s premikom za min, če je določen), da je veljavna. Sprejme posebno vrednost niza any, ki izniči omejitev preverjanja veljavnosti in povzroči, da se vrednost pri posameznem koraku poveča ali zmanjša za 1. |
trackColor |
string |
Barvni niz CSS za prilagoditev ozadja elementa proge. |
withInputField |
boolean |
Določa, ali se ob polju za vnos števila izriše tudi RangeControl. Če je step nastavljen na posebno vrednost niza any, se ta lastnost prepiše z vrednostjo false. |
izbor
Izriše izbirno polje, ki podpira enojno ali večkratno izbiro.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
array | string | number |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
array | string | number |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
multiple |
boolean |
Če je true, je mogoče izbrati več možnosti. »stylisedUi« se samodejno omogoči. |
options |
array |
Možnosti za izbiro. |
returnFormat |
string |
Določa obliko vrnjene vrednosti. |
populate |
object |
|
stylisedUi |
boolean |
Izriše oblikovano različico izbirnega polja, po kateri je mogoče iskati elemente. |
allowNull |
boolean | string |
Uporabniku omogoča izbiro prazne možnosti. Če je true, bo oznaka prazna, sicer bo možnost prikazala določen niz. |
allowReset |
boolean |
Če je ta lastnost true, se izriše gumb za ponastavitev izbirnega polja. |
zavihki
Izriše vmesnik z zavihki za združevanje polj.
{
"type": "tabs"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
tabs |
array |
Zavihki za prikaz. |
besedilo
Izriše enovrstično vnosno polje za besedilo.
{
"type": "text",
"min": 0,
"max": 100
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
max |
number |
Največja dolžina vrednosti. |
min |
number |
Najmanjša dolžina vrednosti. |
besedilno območje
Izriše vnosno polje za večvrstično besedilo.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
max |
number |
Največja dolžina vrednosti. |
min |
number |
Najmanjša dolžina vrednosti. |
rows |
number |
Število vrstic, ki naj jih vsebuje besedilno območje. |
preklop
Izriše preklop za vrednosti true/false.
{
"type": "toggle"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
boolean |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
boolean |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
ponavljalnik
Izriše nabor polj, ki jih je mogoče ponavljati.
{
"type": "repeater",
"min": 0,
"max": 100
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
array |
Vrstice, s katerimi se začne nov blok. Vsaka vrstica je objekt vrednosti polj. Imajo prednost pred vrsticami, ki jih ustvari min. |
min |
number |
Najmanjše število vrstic. |
max |
number |
Največje število vrstic. |
minimized |
boolean |
Ob odprtju urejevalnika strne obstoječe vrstice. Vrstice, dodane v urejevalniku, so razširjene. |
textButton |
string |
Besedilo gumba za dodajanje. |
textMinimized |
string | object |
Besedilo, prikazano, ko so vrstice strnjene. |
textRemove |
string | boolean |
Potrditveno vprašanje, prikazano v urejevalniku ob odstranitvi vrstice ponavljalnika. Neprazen niz spremeni vprašanje; false odstrani vrstico takoj, brez pogovornega okna. Če je možnost izpuščena, nastavljena na true ali prazen niz, se uporabi privzeto vprašanje. |
attributes |
array |
Sprejema vse druge vrste polj razen polja zavihkov. |
richtext
Polje atributa za polja RichText.
{
"type": "richtext"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, prikazana, ko je vrednost polja prazna. |
unit
Izriše vnosno polje za število s spustnim seznamom enot.
{
"type": "unit"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, prikazana, ko je vrednost polja prazna. |
disableUnits |
boolean |
Če je true, je polje za izbiro enote skrito. |
isPressEnterToChange |
boolean |
Če je true, je za sprožitev dogodka onChange potreben pritisk tipke ENTER. Če je možnost omogočena, se sprememba sproži tudi ob premiku iz polja s tabulatorjem. |
isResetValueOnUnitChange |
boolean |
Če je true in izbrana enota določa privzeto vrednost, se ta nastavi ob spremembi enot. |
isUnitSelectTabbable |
boolean |
Določa, ali je polje za izbiro enote dosegljivo s tabulatorjem. |
units |
array |
wysiwyg
Izriše urejevalnik WYSIWYG.
{
"type": "wysiwyg"
}
Lastnosti
| Lastnost | Vrsta | Opis |
|---|---|---|
default |
string |
Privzeta vrednost, ki se uporabi ob prvem dodajanju bloka. |
fallback |
string |
Nadomestna vrednost, ki se prikaže, ko je vrednost polja prazna. |
toolbar |
object |
Konfiguracija orodne vrstice urejevalnika. |
mode |
string |
code odpre polje v pogledu kode. both doda gumb za preklapljanje med vizualnim pogledom in pogledom kode. |
Nalaganje ikon
Urejevalnik naloži nabor ikon, ko prvič odprete izbirnik ali spremenite nabor ali podnabor, ne pa ob izbiri bloka. Polja, ki zahtevajo isti nabor, si delijo zahtevo, ki še poteka. Shranjeno ime ikone je vidno že pred nalaganjem, ob ponovnem odprtju izbirnika pa se neuspešna zahteva poskusi znova.
tabler-icons podpira outline in filled. Podnabor, izrecno konfiguriran
za izbrani nabor, ima prednost; sicer izbirnik uporabi solid, če je na voljo,
ali prvi podnabor nabora. Nabori brez podnaborov ne vključujejo subSet.
Imena naborov se razrešijo samo v priložene datoteke. Upodabljanje v sprednjem
vmesniku predpomni posamezne ikone, namesto da bi celotne nabore ikon shranilo
v začasne zapise zbirke podatkov.
Uvožene vrednosti možnosti
Potrditvena polja in izbirniki z "multiple": true običajno shranijo polje
objektov { "value": "...", "label": "..." }. Sprejmejo tudi en sam objekt možnosti, skalarni niz ali
število oziroma polje skalarnih vrednosti, uvoženih prek REST API
ali orodij za vsebino. To deluje tudi znotraj vrstic ponavljalnika.
Urejevalnik te vrednosti prikaže kot izbire, ne da bi pri shranjevanju
nespremenjene vsebine prepisal njihovo shranjeno obliko. Dodajanje ali
odstranjevanje izbire shrani običajno polje objektov možnosti. Številčna
vrednost 0 in niz "0" sta veljavni izbiri. Predloge prejmejo
konfigurirano vrednost polja returnFormat, enako kot pri vrednostih, izbranih v
urejevalniku. Možnosti se morajo še vedno ujemati z deklariranimi ali
izpolnjenimi izbirami polja.
Izvorni izbirnik z eno možnostjo brez shranjene ali privzete vrednosti
prikaže onemogočen prazen nadomestni element, ne prve možnosti. Če izrecno
izberete prvo možnost, se ta shrani. Ko je izbira shranjena, nadomestni element
izgine. Uporabite allowNull, kadar naj bi uredniki lahko tudi počistili izbiro;
prazen nadomestni element sam po sebi ne omogoča brisanja sicer obvezne izbire.
Začetne vrstice ponavljalnika
V urejevalniku privzete vrednosti pred vstavljanjem vključujejo tudi ugnezdene najmanjše vrstice. Za njihovo inicializacijo vam ni treba odpreti nastavitev bloka, vstavljanje bloka pa za te vrstice ne doda dodatnega koraka razveljavitve.
Če ima ponavljalnik min, nima pa shranjene vrednosti ali izrecnega default, strežnik inicializira toliko vrstic s privzetimi vrednostmi polj v vrstici. To velja tudi za vdelane vsebine PHP, oznake blokov in vire strani, podprte z datotekami, ki še nikoli niso bili odprti v urejevalniku. Na primer, "min": 2 z besedilnim poljem, katerega privzeta vrednost je "New item", izriše dve vrstici s to vrednostjo.
Shranjene vrstice in izrecni ponavljalnik default imajo prednost. Izrecno shranjen prazen seznam, false ali null ne ustvari znova odstranjenih vrstic. Izris teh ustvarjenih privzetih vrednosti ne zapiše nazaj v objavo. min in max omejujeta kontrolnike v urejevalniku; pri izrisu ne skrajšata shranjenega seznama in vanj ne dodajata vrednosti. Uporabite bs_validate_block() za poročanje o kršitvah omejitev vrstic v uvoženi vsebini.
Polja v vrstici brez default so v ustvarjeni vrstici false, zato taka vrstica nima vsebine. Enako so videti vrstice, ki jih dodajo uredniki in pustijo prazne. Predloga, ki za vsako vrstico izpiše kartico, naslov ali element seznama, naj zunaj urejevalnika preskoči vrstice brez vsebine, v urejevalniku pa naj jih ohrani, da bodo njihova polja ostala urejljiva:
<?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; ?>
Odstranjevanje ponavljalnika
Ob odstranitvi vrstice se odpre potrditveno pogovorno okno urejevalnika z gumboma Izbriši in Prekliči. Če dejanje prekličete ali pritisnete Escape, vrstica ostane nespremenjena. Odstrani se šele po potrditvi, tudi znotraj vgnezdenih ponavljalnikov.
textRemove določa enako vedenje za vse ponavljalnike:
| Vrednost | Vedenje |
|---|---|
Izpuščeno, true ali "" |
Prikaže privzeto potrditveno vprašanje. |
| Neprazen niz | Prikaže vprašanje po meri z obstoječim mehanizmom za prevajanje besedila po meri. |
false |
Takoj odstrani vrstico brez pogovornega okna. |
Na primer, "textRemove": "Remove this team member?" spremeni vprašanje.
Obstoječa omejitev min še vedno preprečuje odstranjevanje vrstic pod najmanjšim dovoljenim številom.
Vgnezdeni ponavljalniki
Vrstica ponavljalnika sprejme vse vrste polj, razen tabs. Polje tabs v vrstici, tudi znotraj skupine brez id, namesto svojih polj prikaže obvestilo v urejevalniku. Razširitev PHPStan o tem poroča za block.json in field.json. Polja v vrstici pustite na isti ravni ali pa zavihke premaknite zunaj ponavljalnika.
Povezave WYSIWYG
Orodna vrstica za povezave WYSIWYG privzeto vstavi povezave, ki se odprejo v istem zavihku, brez atributov target ali rel. Možnost za odpiranje v novem zavihku omogočite z toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Če izberete nov zavihek, se dodata target="_blank" in rel="noreferrer noopener".
Če to možnost izklopite, se ta samodejna atributa odstranita. Če želite uporabiti atribute za vse povezave v tem polju, nastavite toolbar.formats.link.attributes, na primer
{ "class": "content-link", "rel": "nofollow" }. Izrecna konfiguracija se ohrani, varnostna žetona za odpiranje v novem zavihku pa se dodata konfiguriranemu rel.
Če vnesete URL, se ta ne pretvori samodejno v povezavo, klik obstoječe povezave v polju pa vas ne preusmeri iz urejevalnika. Atributi povezav, shranjenih prej, ostanejo v obstoječi vsebini; ne posodobijo se samodejno.