Liigu sisu juurde

Väljatüübid

Blockstudio pakub plokkide kasutajaliideste loomiseks mitmesuguseid väljatüüpe.

Projektid saavad registreerida ka oma nimeruumiga väljatüüpe funktsiooniga blockstudio/field_types. Kasutage seda, kui vajate uut redaktori juhtelementi või struktureeritud väärtuse kuju. Kasutage custom/{name}-välju siis, kui vajate ainult olemasolevate väljade rühma taaskasutamist.

Väljade mustrite retseptikogu

Praktilised juhised: tingimuslikud rühmad, nutikad valikloendid, kordajad ja päritavad salvestusandmed.

Üldised omadused

Allolevas tabelis on loetletud ühised atribuudid ja levinud väärtusevalikud. default ja fallback on toetatud iga väljatüübi omaduste tabelis, kus need on loetletud.

Atribuut Tüüp Kirjeldus
id string Atribuudi kordumatu identifikaator
type string Välja tüüp
label string Redaktoris kuvatav silt
description string Välja all kuvatav kirjeldustekst
default mixed Välja vaikeväärtus
fallback mixed Väärtus, mida kasutatakse, kui väli on tühi
help string Sildi kõrval kohtspikrina kuvatav abitekst
hidden boolean Peida väli UI eest
switch boolean Kuva lüliti, millega saab välja keelata. Vaikimisi on false.
translate boolean Määrake väärtuseks false, et jätta väli WPML konfiguratsioonist välja
conditions array Tingimusloogika reeglid

Väljade failid, millel on "returnFormat": "id", säilitavad imporditud stringviited, ka kordajates üksikväärtuste puhul. Lahendamata nimede korral kuvatakse pisipiltideta varukaardid; Blockstudio ei teisenda neid manuse ID-deks. Lisateavet leiate jaotisest kaasaskantavad meediaviited.

Valijapäringute, korduskatsete ja ikoonide alamhulkade kohta leiate teavet jaotisest ikoonide laadimine.

attributes

Renderdab andmeatribuudi sisestusvälju.

JSON
{
  "type": "attributes"
}

Omadused

Omadus Tüüp Kirjeldus
default array Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback array Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
link boolean Lubab valida lingi rippmenüüst.
media boolean Lubab valida meedia rippmenüüst.

plokk

Viitab teisele Blockstudio plokile ja kuvab selle väljad reas. Mallides tagastatakse väärtus renderdatud ploki väljundina.

JSON
{
  "type": "block"
}

Omadused

Omadus Tüüp Kirjeldus
block string Viidatava ploki nimi (e.g nt „mytheme/card“).
returnFormat string Kuidas väärtus mallides tagastatakse.

märkeruut

Kuvab märkeruutude komplekti.

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

Omadused

Atribuut Tüüp Kirjeldus
default array | string | number Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback array | string | number Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
options array Valitavad suvandid.
returnFormat string Määrab tagastatava vormingu väärtuse.
populate object
toggle boolean | string Lisab suvandite kohale märkeruudu, millega saab need kõik valida või valiku tühistada. Selle silt määratakse stringiga; true kasutab vaikesilti.

klassid

Kuvab välja CSS klasside valimiseks.

JSON
{
  "type": "classes"
}

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
tailwind boolean Kas sellel sisendväljal lubatakse kasutada Tailwind klasse.

kood

Kuvab koodiredaktori.

JSON
{
  "type": "code"
}

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
autoCompletion boolean Kas automaatne täitmine lubada.
foldGutter boolean Kas kuvada voltimisala.
height string Redaktori kõrgus.
language string Süntaksi esiletõstmiseks kasutatav keel.
lineNumbers boolean Kas kuvada reanumbreid.
maxHeight string Redaktori maksimaalne kõrgus.
minHeight string Redaktori minimaalne kõrgus.
popout boolean Kas kuvada nuppu, mis avab redaktori hüpikaknas.
asset boolean Renderdab välja väärtuse CSS, SCSS või JavaScript ploki varana, nii et mallis pole vaja stiili- ega skriptisildit väljastada.

värv

Kuvab värvipaleti ja värvivalija.

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

Omadused

Omadus Tüüp Kirjeldus
default string Väärtus, mis valitakse ploki esmakordsel lisamisel.
fallback string Väärtus, mida kuvatakse, kui välja väärtus on tühi.
options array
populate object
clearable boolean Kas värvipaletis peaks olema tühjendamisnupp.
disableCustomColors boolean Kas lubada kohandatud värvi.

kuupäev

Kuvab kuupäevavalija.

JSON
{
  "type": "date"
}

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
startOfWeek number Nädala alguspäev. 0 tähistab pühapäeva, 1 esmaspäeva jne.

kuupäev-kellaaeg

Kuvab kuupäeva- ja kellaajavalija.

JSON
{
  "type": "datetime"
}

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
is12Hour boolean Kas kasutada 12-tunnist kellavormingut. Sel juhul kuvatakse AM/PM vidin ja kellaaja vorminguks eeldatakse MM-DD-YYYY (vaikimisi DD-MM-YYYY asemel).

failid

Kuvab meediateeki avava nupu. Valitud üksuste järjestust saab muuta otse väljal.

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

Omadused

Omadus Tüüp Kirjeldus
default array | object | number Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback array | object | number Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
addToGallery boolean Kui väärtus on true, avaneb galerii meediaaken otse meediateegis, kus kasutaja saab pilte lisada. Kui väärtus on false, avaneb galerii meediaaken muutmisrežiimis, kus kasutaja saab olemasolevaid pilte järjestada, eemaldada või nende atribuute muuta. Kehtib ainult siis, kui gallery === true.
allowedTypes array | string Massiiv meediatüüpidega, mida saab meediateeki üles laadida või sealt valida. Iga tüüp on string, mis võib sisaldada üldist MIME-tüüpi e.g: ‘image’, ‘audio’, ‘text’ või täielikku MIME-tüüpi e.g: ‘audio/mpeg’, ‘image/gif’. Kui allowedTypes pole määratud, lubatakse kõiki MIME-tüüpe.
gallery boolean Kui väärtus on true, lähtestab komponent galerii kuvamiseks vajalikud olekud. Vaikimisi avaneb meediaaken galerii muutmisvaates, kuid seda saab muuta lipuga addToGalleryflag.
max number Lisatavate failide maksimaalne arv.
min number Lisatavate failide minimaalne arv.
multiple boolean Kas lubada mitme üksuse valimine.
size boolean Lisab väljale meedia suuruse rippmenüü.
textMediaButton string Meedianupu tekst.
title string Meediaaknas kuvatav pealkiri.
returnFormat string Määrab tagastatava väärtuse vormingu.
returnSize string Tagastatav meedia suurus, kui kasutatakse vormingut URL.

gradient

Kuvab gradiendipaleti ja gradiendivalija.

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

Omadused

Omadus Tüüp Kirjeldus
default string Väärtus, mis valitakse ploki esmakordsel lisamisel.
fallback string Väärtus, mida kuvatakse, kui välja väärtus on tühi.
options array
populate object
clearable boolean Kas värvipaletis peaks olema tühjendamisnupp.
disableCustomGradients boolean Kas lubada kohandatud värvi.

rühm

Kuvab mitu välja (valikuliselt) kokkuklapitavas ümbrises.

JSON
{
  "type": "group"
}

Omadused

Omadus Tüüp Kirjeldus
title string Pealkirja tekst. See kuvatakse ka siis, kui komponent on suletud.
opened boolean Kui väärtuseks on true, jääb komponent avatuks, sõltumata algsest initialOpen omadusest ja
initialOpen boolean Kas paneel on alguses avatud.
scrollAfterOpen boolean Kerib sisu nähtavale, kui see muutub nähtavaks.
class string Rühmale rakendatav kohandatud CSS klass.
style object Rühmale rakendatavad kohandatud CSS stiilid.
attributes array Toetab kõiki muid väljatüüpe peale teise tabs tüübi.

html-silt

Kuvab HTML sildi valija. Sobib pealkirjatasemete või semantiliste elementide valimiseks.

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

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
tags string | array Kaasatavad sildid. Kasutage eelseadistatud stringi või siltide nimede massiivi.
exclude array Eelseadistusest välja jäetavad sildid. Kehtib ainult siltide eelseadistatud stringi kasutamisel.

ikoon

Kuvab ikoonikomplektist pärineva SVG-ikooni.

JSON
{
  "type": "icon"
}

Omadused

Omadus Tüüp Kirjeldus
default object Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback object Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
sets array | string Kaasatav ikoonikomplekt. Tühjaks jättes kaasatakse kõik.
subSets array | string Kaasatav alam-ikoonikomplekt. Tühjaks jättes kaasatakse kõik.
returnFormat string Tagastatava ikooni vorming.

Kuvab juhtimiselementi, mille abil saab valida sise- või välislinke.

JSON
{
  "type": "link"
}

Omadused

Omadus Tüüp Kirjeldus
default object Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback object Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
hasRichPreviews boolean Kas lingi URL lisamisel kuvatakse rikastatud eelvaated.
noDirectEntry boolean Kas lubada muuta URL-laadne otsingupäring otse lingiks.
noURLSuggestion boolean Kas lisada varusoovitus, mis käsitleb otsingupäringut kui URL.
opensInNewTab boolean Lisab lingi aknasse lüliti.
showSuggestions boolean Kas URL sisestamisel soovitusi kuvada.
textButton string Kohandatud tekst linginupus kuvamiseks.
withCreateSuggestion boolean Kas sobiva tulemuseta lingiotsingu korral saab soovitada uue mustandlehe loomist.

teade

Kuvab kohandatud sisuga teate.

JSON
{
  "type": "message"
}

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
value string Kuvatav teade. Ploki ja atribuudi andmed on saadaval nurksulgude süntaksis, e.g: {block.title} või {attributes.text}

number

Kuvab numbrisisendi.

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

Omadused

Omadus Tüüp Kirjeldus
default number Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback number Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
dragDirection string Määrab väärtuse suurendamise või vähendamise lohistamissuuna.
dragThreshold number Kui isDragEnabled on true, määrab pikslite arvu, mille võrra tuleb lohistada enne väärtuse muutumist.
hideHTMLArrows boolean Kui väärtus on true, peidetakse sisendi vaikimisi HTML nooled.
isShiftStepEnabled boolean Kui väärtus on true, lubab hiirega lohistades arvu suurendada või vähendada. Lohistamise ajal SHIFT-klahvi all hoides suurendatakse väärtust shiftStep võrra.
max number Väärtuse maksimaalne pikkus.
min number Väärtuse minimaalne pikkus.
required boolean Kui väärtus on true, nõutakse juhtelemendi min/max vahemikus olevat kehtivat arvu. Kui väärtus on false, lubatakse tühja stringi kehtiva väärtusena.
shiftStep number Suurendus SHIFT-klahvi all hoidmisel. See väärtus korrutab sammu väärtuse. Näiteks kui samm on 5 ja shiftStep on 10, muutub väärtus iga hüppega 50 võrra.
step number Väärtuse muutmise samm suurendamisel või vähendamisel. See mõjutab ka valideerimist: kehtiv väärtus peab olema sammu kordne (nihkega miinimumi võrra, kui see on määratud). Eriväärtus string any tühistab valideerimispiirangu ning sammusammud muudavad väärtust 1 võrra.

raadionupp

Kuvab raadionuppude komplekti.

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

Omadused

Omadus Tüüp Kirjeldus
default string | number Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string | number Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
options array Valitavad suvandid.
returnFormat string Määrab tagastatava väärtuse vormingu.
populate object
display string Määra väärtuseks buttonGroup, et kuvada suvandid raadionuppude asemel nupurühmana.
allowNull boolean Võimaldab kasutajal väärtuse tühjendada, klõpsates uuesti valitud raadionupul.

vahemik

Kuvab vahemiksisendi arvväärtuse määramiseks kahe punkti vahel.

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

Omadused

Omadus Tüüp Kirjeldus
default number Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback number Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
allowReset boolean Kui see omadus on true, kuvatakse liuguri lähtestamisnupp.
initialPosition number Liuguri algasend, mida kasutatakse väärtuse puudumisel. initialPosition piiratakse etteantud min- ja max-omaduse väärtustega.
isShiftStepEnabled boolean Kui väärtus on true, lubab hiirega lohistades arvu suurendada või vähendada. Lohistamise ajal SHIFT-klahvi all hoides suurendatakse väärtust shiftStep võrra.
marks array Kuvab sammutähiste visuaalse esituse. Kohandatud tähised võib esitada massiivina.
max number Maksimaalne väärtus.
min number Minimaalne väärtus.
railColor string CSS värvistring rööpa tausta kohandamiseks.
resetFallbackValue number Väärtus, millele lähtestamisnupu klõpsamisel naasta (lubatakse omadusega allowReset).
separatorType string Määrab, kas juhtelementide rea all olev eraldusjoon peidetakse või ulatub üle kogu laiuse. Vaikimisi paikneb see all ega ulatu juhtikooni alla.
shiftStep number Suurendus SHIFT-klahvi all hoidmisel. See väärtus korrutab sammu väärtuse. Näiteks kui samm on 5 ja shiftStep on 10, muutub väärtus iga hüppega 50 võrra.
showTooltip boolean Sunnib vihjet UI kuvama või peitma. Kui step on eriväärtusega string any, määratakse see väärtus false-ks.
step number Väärtuse muutmise samm suurendamisel või vähendamisel. See mõjutab ka valideerimist: kehtiv väärtus peab olema sammu kordne (nihkega miinimumi võrra, kui see on määratud). Eriväärtus string any tühistab valideerimispiirangu ning sammusammud muudavad väärtust 1 võrra.
trackColor string CSS värvistring raja tausta kohandamiseks.
withInputField boolean Määrab, kas numbriväli kuvatakse RangeControli kõrval. Kui step on eriväärtusega string any, määratakse see väärtus false-ks.

valikuloend

Kuvab ühe või mitme valiku toega valikuloendi.

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

Omadused

Omadus Tüüp Kirjeldus
default array | string | number Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback array | string | number Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
multiple boolean Kui väärtus on true, saab valida mitu suvandit. „stylisedUi“ lubatakse automaatselt.
options array Valitavad suvandid.
returnFormat string Määrab tagastatava väärtuse vormingu.
populate object
stylisedUi boolean Kuvab kujundatud valikuloendi, mille üksusi saab otsida.
allowNull boolean | string Lubab valida tühja valiku. Kui väärtus on true, on silt tühi; vastasel juhul kuvatakse määratud string.
allowReset boolean Kui see omadus on true, kuvatakse valikuloendi lähtestamisnupp.

vahekaardid

Kuvab vahekaartidega liidese väljade rühmitamiseks.

JSON
{
  "type": "tabs"
}

Omadused

Omadus Tüüp Kirjeldus
tabs array Kuvatavad vahekaardid.

tekst

Kuvab üherealise tekstisisendi.

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

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
max number Väärtuse maksimaalne pikkus.
min number Väärtuse minimaalne pikkus.

tekstiala

Kuvab tekstiala sisendi.

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

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
max number Väärtuse maksimaalne pikkus.
min number Väärtuse minimaalne pikkus.
rows number Tekstiala ridade arv.

lüliti

Kuvab tõene/väär-lüliti.

JSON
{
  "type": "toggle"
}

Omadused

Omadus Tüüp Kirjeldus
default boolean Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback boolean Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.

kordaja

Renderdab korduvate väljade komplekti.

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

Omadused

Omadus Tüüp Kirjeldus
default array Uue ploki algsed read. Iga rida on välja väärtuste objekt. See on ülimuslik min-i loodud ridade suhtes.
min number Ridade minimaalne arv.
max number Ridade maksimaalne arv.
minimized boolean Ahenda olemasolevad read redaktori avamisel. Redaktoris lisatud read on alguses laiendatud.
textButton string Lisamisnupu tekst.
textMinimized string | object Tekst, mida kuvatakse ridade ahendamisel.
textRemove string | boolean Kinnitus küsimus, mida kuvatakse redaktoris kordaja rea eemaldamisel. Mittetühi string muudab küsimust; false eemaldab rea kohe ilma dialoogita. Puuduva väärtuse, true või tühja stringi korral kasutatakse vaikeküsimust.
attributes array Toetab kõiki muid väljatüüpe peale teise tabs-välja.

rikastekst

RichText-väljade atribuudi väli.

JSON
{
  "type": "richtext"
}

Omadused

Atribuut Tüüp Kirjeldus
default string Vaikeväärtus, mis määratakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.

ühik

Renderdab ühiku rippmenüüga numbrisisestusvälja.

JSON
{
  "type": "unit"
}

Omadused

Atribuut Tüüp Kirjeldus
default string Vaikeväärtus, mis määratakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
disableUnits boolean Kui väärtus on true, on ühiku valimise väli peidetud.
isPressEnterToChange boolean Kui väärtus on true, tuleb onChange’i käivitamiseks vajutada ENTER-klahvi. Kui see on lubatud, käivitub muudatus ka fookuse järgmisele väljale viimisel.
isResetValueOnUnitChange boolean Kui väärtus on true ja valitud ühikul on vaikeväärtus, määratakse see ühiku muutmisel.
isUnitSelectTabbable boolean Määrab, kas ühiku valimise väljale saab tabeldusklahviga liikuda.
units array

wysiwyg

Renderdab WYSIWYG-redaktori.

JSON
{
  "type": "wysiwyg"
}

Omadused

Omadus Tüüp Kirjeldus
default string Vaikeväärtus, mis rakendatakse ploki esmakordsel lisamisel.
fallback string Varuväärtus, mida kuvatakse, kui välja väärtus on tühi.
toolbar object Redaktori tööriistariba seaded.
mode string code avab välja koodivaates. both lisab nupu, millega saab visuaal- ja koodivaate vahel vahetada.

Ikoonide laadimine

Redaktor laadib ikoonikomplekti siis, kui selle valija esimest korda fookuse saab või komplekti või alamhulka muudetakse, mitte ploki valimisel. Sama komplekti vajavad väljad jagavad pooleliolevat päringut. Salvestatud ikooninimi jääb enne laadimist nähtavale ja valijale uuesti fookuse andmine käivitab nurjunud päringu uuesti.

tabler-icons toetab outline ja filled. Valitud komplekti jaoks selgesõnaliselt seadistatud alamhulk on ülimuslik; vastasel juhul kasutab valija võimaluse korral solid või komplekti esimest alamhulka. Alamhulkadeta komplektide puhul jäetakse subSet välja. Komplektide nimed vastendatakse ainult komplekti kuuluvatele failidele. Esikülje renderdamisel salvestatakse vahemällu üksikud ikoonid, mitte terveid ikoonikomplekte andmebaasi ajutistesse kirjetesse.

Imporditud suvandite väärtused

"multiple": true-iga märkeruudud ja valikuväljad salvestavad tavaliselt massiivi, mis sisaldab { "value": "...", "label": "..." }-objekte. Need toetavad ka üht suvandiobjekti, skalaarset stringi või arvu ning skalaarväärtuste massiivi, mis on imporditud REST API või sisutööriistade kaudu. See toimib ka kordaja ridade sees.

Redaktor kuvab need väärtused valikutena ega kirjuta nende salvestatud struktuuri muutmata kujul salvestamisel ümber. Valiku lisamisel või eemaldamisel salvestatakse tavapärane suvandiobjektide massiiv. Arvuline 0 ja string "0" on kehtivad valikud. Mallid saavad välja seadistatud returnFormat samamoodi nagu redaktoris valitud väärtuste puhul. Suvandid peavad endiselt vastama välja määratud või täidetud valikutele.

Natiivne ühe valikuga valikuväli, millel pole salvestatud väärtust ega vaikeväärtust, kuvab esimese suvandi asemel keelatud tühja kohatäitja. Esimese suvandi selgesõnalisel valimisel see salvestatakse. Kui valik on salvestatud, kohatäitja kaob. Kasutage allowNull, kui redaktorid peaksid saama valiku ka tühjendada; tühi kohatäitja ei võimalda muul juhul nõutavat valikut tühjendada.

Kordaja algread

Redaktoris hõlmavad vaikeväärtused enne lisamist ka pesastatud miinimumridu. Nende lähtestamiseks ei pea ploki seadeid avama ning ploki lisamine ei loo nende ridade jaoks teist tagasivõtutoimingut.

Kui kordajal on min, kuid puudub salvestatud väärtus või selgesõnaline default, lähtestab server nii mitu rida, kasutades rea väljade vaikeväärtusi. See kehtib ka PHP manuste, plokisiltide ja failipõhiste leheallikate kohta, mida pole kunagi redaktoris avatud. Näiteks "min": 2 tekstiväljaga, mille vaikeväärtus on "New item", kuvab kaks rida, mis sisaldavad seda väärtust.

Salvestatud read ja kordaja selgesõnaline default on ülimuslikud. Selgesõnaliselt salvestatud tühi loend, false või null ei taasta eemaldatud ridu. Renderdamine ei kirjuta neid loodud vaikeväärtusi postitusele tagasi. min ja max piiravad redaktori juhtelemente; need ei kärbi ega täienda salvestatud loendit renderdamisel. Kasutage bs_validate_block(), et teatada imporditud sisu rea piirangute rikkumistest.

Reaväljad, millel puudub default, on loodud reas false, mistõttu sellisel real sisu puudub. Sama kehtib ridade kohta, mille redaktor lisab ja tühjaks jätab. Mall, mis kuvab iga rea kohta kaardi, pealkirja või loendiüksuse, peaks sisutud read väljaspool redaktorit vahele jätma ja redaktoris alles hoidma, et nende välju saaks endiselt muuta:

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

Kordaja ridade eemaldamine

Rea eemaldamisel avaneb redaktoris kinnitusdialoog nuppudega Kustuta ja Tühista. Tühistamine või paoklahvi vajutamine jätab rea muutmata. Rida eemaldatakse alles pärast kinnitamist, sealhulgas pesastatud kordajate puhul.

textRemove juhib sama käitumist kõigi kordajate puhul:

Väärtus Käitumine
Ära jäetud, true või "" Kuvatakse vaikimisi kinnitusküsimus.
Mittetühi string Kuvatakse kohandatud küsimus olemasoleva kohandatud teksti tõlkemehhanismi abil.
false Rida eemaldatakse kohe ilma dialoogita.

Näiteks "textRemove": "Remove this team member?" muudab küsimust. Olemasolev piirang min takistab endiselt minimaalset arvu ületavalt ridade eemaldamist.

Kordajate pesastamine

Kordaja rida aktsepteerib kõiki väljatüüpe peale tabs. Reas olev tabs väli, ka rühmas, millel puudub id, kuvab redaktoris väljade asemel teate. Laiendus PHPStan annab sellest teada nii block.json kui ka field.json puhul. Hoidke rea väljad ühel tasemel või viige vahekaardid kordajast väljapoole.

WYSIWYG-lingi tööriistariba lisab vaikimisi samas vahekaardis avanevad lingid, lisamata target ega rel. Uue vahekaardi valiku saab lubada sättega toolbar.formats.link.opensInNewTab:

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

Uue vahekaardi valimine lisab target="_blank" ja rel="noreferrer noopener". Selle väljalülitamisel eemaldatakse need automaatsed atribuudid. Kõigile selle välja linkidele atribuutide määramiseks seadke toolbar.formats.link.attributes, näiteks { "class": "content-link", "rel": "nofollow" }. Selgesõnaline konfiguratsioon säilitatakse ning uue vahekaardi turvatokenid lisatakse seadistatud rel-le.

Sisestatud URL ei muutu automaatselt lingiks ning väljal olemasoleval lingil klõpsamine ei vii redaktorist välja. Varem salvestatud lingiatribuudid jäävad olemasolevasse sisusse; neid ei migreerita automaatselt.