Preskoči na vsebino

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.

Kuharica vzorcev 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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

Izriše kontrolnik povezave za izbiro notranjih ali zunanjih povezav.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "type": "tabs"
}

Lastnosti

Lastnost Vrsta Opis
tabs array Zavihki za prikaz.

besedilo

Izriše enovrstično vnosno polje za besedilo.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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
<?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.

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:

JSON
{
  "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.