Siirry sisältöön

Kenttätyypit

Blockstudio tarjoaa erilaisia kenttätyyppejä lohkojen käyttöliittymien rakentamiseen.

Projektit voivat myös rekisteröidä omia nimiavaruudellisia kenttätyyppejään blockstudio/field_types-toiminnolla. Käytä sitä, kun tarvitset uuden editorin ohjaimen tai jäsennellyn arvomuodon. Käytä custom/{name}-kenttiä, kun haluat vain käyttää uudelleen olemassa olevien kenttien ryhmää.

Kenttämallien keittokirja

Käytännön ohjeita: ehdolliset ryhmät, älykkäät valinnat, toistimet ja kyseltävä tallennus.

Yleiset ominaisuudet

Alla olevassa taulukossa luetellaan yhteiset ominaisuudet ja yleiset arvoasetukset. default ja fallback ovat tuettuja kunkin kenttätyypin Ominaisuudet-taulukossa, jos ne on siinä lueteltu.

Ominaisuus Tyyppi Kuvaus
id string Attribuutin yksilöllinen tunniste
type string Kentän tyyppi
label string Editorissa näkyvä näyttönimi
description string Kentän alla näkyvä kuvausteksti
default mixed Kentän oletusarvo
fallback mixed Vara-arvo, kun kenttä on tyhjä
help string Vihjeteksti, joka näkyy työkaluvihjeenä nimen vieressä
hidden boolean Piilota kenttä kohteesta UI
switch boolean Näytä valitsin, jolla kentän voi poistaa käytöstä. Oletusarvo on false.
translate boolean Aseta arvoksi false, jotta kenttä jätetään pois WPML-määrityksestä
conditions array Ehdollisen logiikan säännöt

Tiedostokentät, joiden "returnFormat": "id" on käytössä, säilyttävät tuodut merkkijonoviitteet, myös toistimien yksittäiset arvot. Selvittämättömät nimet näyttävät varakortit ilman pikkukuvia; Blockstudio ei ratkaise niitä liitetunnuksiksi. Katso lisätietoja kohdasta siirrettävien mediatiedostojen viitteet.

Katso kohdasta Kuvakkeiden lataaminen valitsimen pyynnöt, uudelleenyritykset ja kuvakkeiden osajoukot.

attributes

Näyttää data-attribuuttien syötekentät.

JSON
{
  "type": "attributes"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default array Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback array Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
link boolean Ottaa käyttöön linkin valinnan avattavasta valikosta.
media boolean Ottaa käyttöön median valinnan avattavasta valikosta.

lohko

Viittaa toiseen Blockstudio-lohkoon ja laajentaa sen kentät näkyviin. Mallipohjissa arvo palauttaa renderöidyn lohkon tulosteen.

JSON
{
  "type": "block"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
block string Viitattavan lohkon nimi (e.g, "mytheme/card").
returnFormat string Miten arvo palautetaan mallipohjissa.

valintaruutu

Näyttää joukon valintaruutuja.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default array | string | number Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback array | string | number Vara-arvo, joka näytetään, kun kentän arvo on tyhjä.
options array Valittavissa olevat vaihtoehdot.
returnFormat string Määrittää palautusarvon muodon.
populate object
toggle boolean | string Lisää vaihtoehtojen yläpuolelle valintaruudun, jolla ne kaikki valitaan tai niiden valinta poistetaan. Sen nimikkeenä käytetään merkkijonoa; arvolla true käytetään oletusnimikettä.

luokat

Näyttää kentän CSS-luokkien valintaan.

JSON
{
  "type": "classes"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
tailwind boolean Määrittää, otetaanko Tailwind-luokat käyttöön tässä syötekentässä.

koodi

Näyttää koodieditorin.

JSON
{
  "type": "code"
}

Ominaisuudet

Property Type Description
default string Oletusarvo, jota käytetään lohkoa ensimmäistä kertaa lisättäessä.
fallback string Vara-arvo, joka näytetään, kun kentän arvo on tyhjä.
autoCompletion boolean Otetaanko automaattinen täydennys käyttöön.
foldGutter boolean Näytetäänkö taittosarake.
height string Muokkaimen korkeus.
language string Syntaksikorostuksessa käytettävä kieli.
lineNumbers boolean Näytetäänkö rivinumerot.
maxHeight string Muokkaimen enimmäiskorkeus.
minHeight string Muokkaimen vähimmäiskorkeus.
popout boolean Näytetäänkö painike, joka avaa muokkaimen ponnahdusikkunassa.
asset boolean Hahmontaa kentän arvon CSS, SCSS tai JavaScript lohkon resurssiksi, jolloin mallipohjan ei tarvitse tulostaa tyyli- tai komentosarjatunnistetta.

väri

Näyttää väripaletin ja värivalitsimen.

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

Ominaisuudet

Property Type Description
default string Valinnan arvo, joka valitaan, kun lohko lisätään ensimmäistä kertaa.
fallback string Valinnan arvo, joka näytetään, kun kentän arvo on tyhjä.
options array
populate object
clearable boolean Onko paletissa tyhjennyspainike.
disableCustomColors boolean Sallitaanko mukautettu väri.

päivämäärä

Näyttää päivämäärävalitsimen.

JSON
{
  "type": "date"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
startOfWeek number Viikon aloituspäivä. 0 tarkoittaa sunnuntaita, 1 maanantaita jne.

päivämäärä ja aika

Näyttää päivämäärä- ja aikavalitsimen.

JSON
{
  "type": "datetime"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
is12Hour boolean Käytetäänkö 12 tunnin kelloa. Tällöin näytetään AM/PM-valitsin, ja ajan oletetaan olevan muodossa MM-DD-YYYY (oletusmuodon DD-MM-YYYY sijaan).

tiedostot

Näyttää mediakirjastoon vievän painikkeen. Valittujen kohteiden järjestystä voi muuttaa suoraan.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default array | object | number Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback array | object | number Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
addToGallery boolean Jos arvo on true, gallerian mediavalintaikkuna avautuu suoraan mediakirjastoon, jossa käyttäjä voi lisätä kuvia. Jos arvo on false, ikkuna avautuu muokkaustilaan, jossa käyttäjä voi muokata olemassa olevia kuvia muuttamalla niiden järjestystä, poistamalla niitä tai vaihtamalla niiden määritteitä. Käytössä vain, jos gallery === true.
allowedTypes array | string Taulukko mediatyypeistä, joita voi ladata tai valita mediakirjastosta. Kukin tyyppi on merkkijono, joka voi sisältää yleisen MIME-tyypin e.g: ‘image’, ‘audio’, ‘text’ tai täydellisen MIME-tyypin e.g: ‘audio/mpeg’, ‘image/gif’. Jos allowedTypes-arvoa ei ole asetettu, kaikki MIME-tyypit sallitaan.
gallery boolean Jos arvo on true, komponentti alustaa kaikki gallerian esittämiseen tarvittavat tilat. Oletusarvoisesti median valintaikkuna avautuu gallerian muokkausnäkymässä, mutta tätä voi muuttaa addToGalleryflag-asetuksella.
max number Lisättävien tiedostojen enimmäismäärä.
min number Lisättävien tiedostojen vähimmäismäärä.
multiple boolean Määrittää, sallitaanko useiden kohteiden valinta.
size boolean Lisää kenttään median koon avattavan valikon.
textMediaButton string Median painikkeen teksti.
title string Median valintaikkunassa näkyvä otsikko.
returnFormat string Määrittää palautettavan arvon muodon.
returnSize string Palautettavan median koko, kun käytössä on URL-palautusmuoto.

liukuväri

Näyttää liukuväripaletin ja liukuvärivalitsimen

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

Ominaisuudet

Property Type Description
default string Valinnan arvo, joka valitaan, kun lohko lisätään ensimmäistä kertaa.
fallback string Valinnan arvo, joka näytetään, kun kentän arvo on tyhjä.
options array
populate object
clearable boolean Onko paletissa tyhjennyspainike.
disableCustomGradients boolean Sallitaanko mukautettu väri.

ryhmä

Näyttää useita kenttiä (haluttaessa) kokoon taitettavassa säilössä.

JSON
{
  "type": "group"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
title string Otsikkoteksti. Se näkyy myös komponentin ollessa suljettuna.
opened boolean Kun arvoksi asetetaan true, komponentti pysyy avoinna initialOpen-ominaisuuden arvosta riippumatta ja
initialOpen boolean Määrittää, avataanko paneeli aluksi.
scrollAfterOpen boolean Vierittää sisällön näkyviin, kun se tulee esiin.
class string Ryhmään lisättävä mukautettu CSS-luokka.
style object Ryhmään lisättävät mukautetut CSS-tyylit.
attributes array Hyväksyy kaikki muut kenttätyypit paitsi toisen välilehden.

html-tag

Näyttää HTML-tunnisteen valitsimen. Sopii otsikkotasojen tai semanttisten elementtien valintaan.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
tags string | array Sisällytettävät tunnisteet. Käytä valmista merkkijonoa tai tunnisteiden nimien taulukkoa.
exclude array Valmiista joukosta pois jätettävät tunnisteet. Käytössä vain, kun tunnisteille käytetään valmista merkkijonoa.

kuvake

Näyttää SVG-kuvakkeen kuvakekokoelmasta.

JSON
{
  "type": "icon"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default object Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback object Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
sets array | string Sisällytettävä kuvakekokoelma. Jätä tyhjäksi, jos haluat sisällyttää kaikki.
subSets array | string Sisällytettävä kuvakekokoelman osajoukko. Jätä tyhjäksi, jos haluat sisällyttää kaikki.
returnFormat string Muoto, jossa kuvake palautetaan.

Näyttää linkkiohjaimen sisäisten tai ulkoisten linkkien valintaan.

JSON
{
  "type": "link"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default object Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback object Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
hasRichPreviews boolean Määrittää, näytetäänkö linkkiä lisättäessä rikastettuja esikatseluja URL.
noDirectEntry boolean Määrittää, voiko URL-tyyppisestä hakulausekkeesta luoda suoraan linkin.
noURLSuggestion boolean Määrittää, lisätäänkö varavaihtoehdoksi ehdotus, joka käsittelee hakulausekkeen URL-arvona.
opensInNewTab boolean Lisää linkki-ikkunaan vaihtokytkimen.
showSuggestions boolean Määrittää, näytetäänkö ehdotuksia, kun kirjoitetaan URL.
textButton string Linkkipainikkeen sisällä näytettävä mukautettu teksti.
withCreateSuggestion boolean Määrittää, voiko linkkihaun tuloksettomuudesta seurata uuden luonnossivun ehdotus.

viesti

Näyttää viestin mukautetulla sisällöllä.

JSON
{
  "type": "message"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
value string Näytettävä viesti. Lohkon ja määritteiden tiedot ovat käytettävissä hakasuljesyntaksilla, e.g, esim.: {block.title} tai {attributes.text}

numero

Näyttää numerosyötekentän.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default number Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback number Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
dragDirection string Määrittää arvon suurentamiseen tai pienentämiseen käytettävän vetosuunnan.
dragThreshold number Jos isDragEnabled on true, tämä määrittää vedettävän matkan pikseleinä ennen arvon muuttumista.
hideHTMLArrows boolean Jos arvo on true, oletusarvoisen syötteen HTML-nuolet piilotetaan.
isShiftStepEnabled boolean Jos arvo on true, hiirellä vetäminen suurentaa tai pienentää lukuarvoa. SHIFT-näppäimen pitäminen painettuna vetämisen aikana suurentaa arvoa shiftStep-arvolla.
max number Arvon enimmäispituus.
min number Arvon vähimmäispituus.
required boolean Jos arvo on true, kelvollisen numeron on oltava ohjaimen min/max-alueella. Jos arvo on false, tyhjä merkkijono kelpaa arvoksi.
shiftStep number SHIFT-näppäimen ollessa painettuna lisättävä määrä. Tämä siirtoarvo on step-arvon kerroin. Jos step-arvo on esimerkiksi 5 ja shiftStep-arvo 10, arvo suurenee tai pienenee kullakin kerralla 50.
step number Arvon suurennus- tai pienennysmäärä. Arvo vaikuttaa myös kelpoisuuden tarkistukseen: arvon on oltava step-arvon monikerta (min-arvolla siirrettynä, jos se on määritetty). Hyväksyy erikoismerkkijonon any, joka poistaa tämän kelpoisuusehdon ja saa arvon muuttumaan askeltoiminnoilla yhdellä.

valintanappi

Näyttää joukon valintanappeja.

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

Ominaisuudet

Property Type Description
default string | number Oletusarvo, jota käytetään lohkoa ensimmäistä kertaa lisättäessä.
fallback string | number Vara-arvo, joka näytetään, kun kentän arvo on tyhjä.
options array Valittavissa olevat vaihtoehdot.
returnFormat string Määrittää palautusarvon muodon.
populate object
display string Aseta arvoksi buttonGroup, jos haluat näyttää vaihtoehdot painikeryhmänä radiopainikkeiden sijaan.
allowNull boolean Antaa käyttäjän tyhjentää arvon napsauttamalla valittua radiopainiketta uudelleen.

liukusäädin

Näyttää liukusäätimen, jolla asetetaan lukuarvo kahden pisteen väliltä.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default number Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback number Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
allowReset boolean Jos tämän ominaisuuden arvo on true, liukusäätimen nollauspainike näytetään.
initialPosition number Liukusäätimen aloituskohta, jota käytetään, kun arvoa ei anneta. initialPosition rajataan annettujen min- ja max-ominaisuuksien välille.
isShiftStepEnabled boolean Jos arvo on true, hiirellä vetäminen suurentaa tai pienentää lukuarvoa. SHIFT-näppäimen pitäminen painettuna vetämisen aikana suurentaa arvoa shiftStep-arvolla.
marks array Näyttää askelmerkit visuaalisesti. Mukautetut merkit voi antaa taulukkona.
max number Arvon enimmäispituus.
min number Arvon vähimmäispituus.
railColor string CSS-värimerkkijono, jolla mukautetaan kiskoelementin taustaa.
resetFallbackValue number Arvo, johon palataan, jos Nollaa-painiketta napsautetaan (käytössä allowReset-asetuksella).
separatorType string Määrittää, poistetaanko ohjausrivin ylä- tai alapuolinen erotinviiva käytöstä vai näytetäänkö se koko leveydeltä. Oletusarvoisesti se näytetään alapuolella, ohjauskuvakkeen alleviivausta lukuun ottamatta.
shiftStep number SHIFT-näppäimen ollessa painettuna lisättävä määrä. Tämä siirtoarvo on step-arvon kerroin. Jos step-arvo on esimerkiksi 5 ja shiftStep-arvo 10, arvo suurenee tai pienenee kullakin kerralla 50.
showTooltip boolean Pakottaa työkaluvihjeen UI näkyviin tai piiloon. Asetukseksi vaihtuu false, jos step-arvoksi asetetaan erikoismerkkijono any.
step number Arvon suurennus- tai pienennysmäärä. Arvo vaikuttaa myös kelpoisuuden tarkistukseen: arvon on oltava step-arvon monikerta (min-arvolla siirrettynä, jos se on määritetty). Hyväksyy erikoismerkkijonon any, joka poistaa tämän kelpoisuusehdon ja saa arvon muuttumaan askeltoiminnoilla yhdellä.
trackColor string CSS-värimerkkijono, jolla mukautetaan rataelementin taustaa.
withInputField boolean Määrittää, näytetäänkö numerosyötekenttä RangeControl-säätimen vieressä. Asetukseksi vaihtuu false, jos step-arvoksi asetetaan erikoismerkkijono any.

valintalista

Näyttää valintalistan, joka tukee yhden tai usean vaihtoehdon valintaa.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default array | string | number Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback array | string | number Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
multiple boolean Jos arvo on true, voi valita useita vaihtoehtoja. stylisedUi otetaan automaattisesti käyttöön.
options array Valittavissa olevat vaihtoehdot.
returnFormat string Määrittää palautettavan arvon muodon.
populate object
stylisedUi boolean Näyttää tyylitellyn valintalistan, jonka vaihtoehtoja voi hakea.
allowNull boolean | string Sallii tyhjän vaihtoehdon valinnan. Jos arvo on true, otsake on tyhjä; muussa tapauksessa vaihtoehdossa näytetään määritetty merkkijono.
allowReset boolean Jos tämän ominaisuuden arvo on true, valintalistan nollauspainike näytetään.

välilehdet

Näyttää välilehtikäyttöliittymän kenttien ryhmittelyyn.

JSON
{
  "type": "tabs"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
tabs array Näytettävät välilehdet.

teksti

Näyttää yksirivisen tekstisyötekentän.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
max number Arvon enimmäispituus.
min number Arvon vähimmäispituus.

tekstialue

Näyttää tekstialuesyötekentän.

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

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Varaarvo, joka näytetään, kun kentän arvo on tyhjä.
max number Arvon enimmäispituus.
min number Arvon vähimmäispituus.
rows number Tekstialueen rivien määrä.

vaihtokytkin

Näyttää true/false-vaihtokytkimen.

JSON
{
  "type": "toggle"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default boolean Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback boolean Varaarvo, joka näytetään, kun kentän arvo on tyhjä.

toistin

Näyttää toistettavissa olevien kenttien joukon.

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

Ominaisuudet

Property Type Description
default array Rivien arvot, joilla uusi lohko alustetaan. Kukin rivi on kenttäarvoista koostuva objekti. Ohittaa min-arvon luomat rivit.
min number Rivien vähimmäismäärä.
max number Rivien enimmäismäärä.
minimized boolean Tiivistä olemassa olevat rivit, kun muokkain avautuu. Muokkaimessa lisätyt rivit avautuvat laajennettuina.
textButton string Lisää-painikkeen teksti.
textMinimized string | object Teksti, joka näytetään, kun rivit on tiivistetty.
textRemove string | boolean Vahvistuskysymys, joka näytetään muokkaimessa toistimen riviä poistettaessa. Muu kuin tyhjä merkkijono muuttaa kysymystä; false poistaa rivin heti ilman valintaikkunaa. Jos arvo puuttuu, on true tai tyhjä merkkijono, käytetään oletuskysymystä.
attributes array Hyväksyy kaikki muut kenttätyypit paitsi toiset välilehdet.

richtext

RichText-kenttien attribuuttikenttä.

JSON
{
  "type": "richtext"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Vara-arvo, joka näytetään, kun kentän arvo on tyhjä.

unit

Näyttää numerokentän ja yksikkövalikon.

JSON
{
  "type": "unit"
}

Ominaisuudet

Ominaisuus Tyyppi Kuvaus
default string Oletusarvo, jota käytetään, kun lohko lisätään ensimmäisen kerran.
fallback string Vara-arvo, joka näytetään, kun kentän arvo on tyhjä.
disableUnits boolean Jos arvo on true, yksikön valintakenttä piilotetaan.
isPressEnterToChange boolean Jos arvo on true, ENTER-näppäintä on painettava, jotta onChange käynnistyy. Muutos käynnistyy myös, kun siirrytään kentästä sarkainnäppäimellä.
isResetValueOnUnitChange boolean Jos arvo on true ja valitulla yksiköllä on oletusarvo, tämä arvo asetetaan yksikköä vaihdettaessa.
isUnitSelectTabbable boolean Määrittää, voiko yksikön valintakenttään siirtyä sarkainnäppäimellä.
units array

wysiwyg

Näyttää WYSIWYG-editorin.

JSON
{
  "type": "wysiwyg"
}

Ominaisuudet

Property Type Description
default string Oletusarvo, jota käytetään lohkoa ensimmäistä kertaa lisättäessä.
fallback string Vara-arvo, joka näytetään, kun kentän arvo on tyhjä.
toolbar object Muokkaimen työkalupalkin määritys.
mode string code avaa kentän koodinäkymässä. both lisää painikkeen, jolla voi vaihtaa visuaalisen näkymän ja koodinäkymän välillä.

Kuvakkeiden lataaminen

Muokkain lataa kuvakesarjan, kun sen valitsin kohdistetaan ensimmäistä kertaa tai sarjaa tai alijoukkoa vaihdetaan, ei lohkoa valittaessa. Samaa sarjaa pyytävät kentät jakavat käynnissä olevan latauspyynnön. Tallennettu kuvakkeen nimi näkyy ennen lataamista, ja epäonnistunut pyyntö yritetään uudelleen, kun valitsin kohdistetaan uudelleen.

tabler-icons tukee outline ja filled. Valitulle sarjalle erikseen määritetty alijoukko on etusijalla; muussa tapauksessa valitsin käyttää saatavilla olevaa solid-arvoa tai sarjan ensimmäistä alijoukkoa. Sarjoista, joilla ei ole alijoukkoja, jätetään subSet pois. Sarjojen nimet viittaavat vain mukana toimitettuihin tiedostoihin. Käyttöliittymän hahmonnus tallentaa välimuistiin yksittäisiä kuvakkeita sen sijaan, että koko kuvakesarjat tallennettaisiin tietokannan tilapäistietoihin.

Tuodut vaihtoehtojen arvot

Valintaruudut ja valintalistat, joilla on "multiple": true, tallentavat tavallisesti taulukon { "value": "...", "label": "..." }-objekteja. Ne hyväksyvät myös yksittäisen vaihtoehto-objektin, skalaariarvoisen merkkijonon tai luvun tai skalaariarvojen taulukon, joka on tuotu REST API-toiminnolla tai sisältötyökalulla. Tämä toimii myös toistimen riveillä.

Muokkain näyttää nämä arvot valintoina muuttamatta tallennettua muotoa, jos arvoja ei muokata tallennuksen yhteydessä. Valinnan lisääminen tai poistaminen tallentaa arvot tavalliseen tapaan vaihtoehto-objektien taulukkona. Numeerinen 0 ja merkkijonomuotoinen "0" ovat kelvollisia valintoja. Mallipohjat saavat kentän määritetyn returnFormat-arvon samalla tavalla kuin muokkaimessa valituista arvoista. Vaihtoehtojen on edelleen vastattava kentälle määritettyjä tai täytettyjä vaihtoehtoja.

Alkuperäinen yksittäinen valintalista, jolla ei ole tallennettua arvoa tai oletusarvoa, näyttää käytöstä poistetun tyhjän paikkamerkin ensimmäisen vaihtoehdon sijaan. Ensimmäisen vaihtoehdon valitseminen tallentaa sen. Kun valinta on tallennettu, paikkamerkki katoaa. Käytä allowNull-määritystä, jos muokkaajien on voitava myös tyhjentää valinta; tyhjä paikkamerkki ei mahdollista muuten pakollisen valinnan tyhjentämistä.

Toistimen alkuperäiset rivit

Muokkaimessa oletusarvoihin sisältyvät sisäkkäiset vähimmäisrivit ennen lohkon lisäämistä. Niitä ei tarvitse alustaa avaamalla lohkon asetuksia, eikä lohkon lisääminen lisää näille riveille toista kumoamisaskelta.

Kun toistimella on min mutta ei tallennettua arvoa tai eksplisiittistä default-arvoa, palvelin alustaa näin monta riviä rivikenttien oletusarvoilla. Tämä koskee myös PHP-upotuksia, lohkotageja ja tiedostopohjaisia sivulähteitä, joita ei ole koskaan avattu editorissa. Esimerkiksi "min": 2, jossa tekstikentän oletusarvo on "New item", näyttää kaksi riviä, joissa kummassakin on kyseinen arvo.

Tallennetut rivit ja eksplisiittinen toistimen default ovat etusijalla. Eksplisiittisesti tallennettu tyhjä luettelo, false tai null ei luo poistettuja rivejä uudelleen. Renderöinti ei kirjoita näitä luotuja oletusarvoja takaisin artikkeliin. min ja max rajaavat editorin ohjaimia; ne eivät renderöitäessä katkaise tallennettua luetteloa tai lisää siihen täyterivejä. Ilmoita rivirajojen rikkomuksista tuodussa sisällössä komennolla bs_validate_block().

Rivikentät, joilla ei ole default-arvoa, ovat luodulla rivillä false, joten tällaisella rivillä ei ole sisältöä. Myös editorissa lisätyt tyhjiksi jätetyt rivit näyttävät samalta. Mallineen, joka tulostaa jokaiselle riville kortin, otsikon tai luettelokohdan, tulee ohittaa sisällöttömät rivit editorin ulkopuolella ja säilyttää ne editorissa, jotta niiden kenttiä voi edelleen muokata:

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

Toistimen rivin poistaminen

Rivin poistaminen avaa editorin vahvistusvalintaikkunan, jossa on painikkeet Poista ja Peruuta. Peruuta-painike tai Escape jättää rivin ennalleen. Rivi poistetaan vasta vahvistuksen jälkeen, myös sisäkkäisissä toistimissa.

textRemove määrittää saman toiminnan kaikille toistimille:

Arvo Toiminta
Pois jätetty, true tai "" Näytä oletusvahvistuskysymys.
Muu kuin tyhjä merkkijono Näytä mukautettu kysymys nykyistä mukautetun tekstin käännösmekanismia käyttäen.
false Poista rivi heti ilman valintaikkunaa.

Esimerkiksi "textRemove": "Remove this team member?" muuttaa kysymystä. Nykyinen min-rajoitus estää edelleen vähimmäismäärää pienemmän rivimäärän.

Toistimien sisäkkäisyys

Toistimen rivi hyväksyy kaikki kenttätyypit paitsi tabs. Rivillä oleva tabs-kenttä, myös ryhmän sisällä, jolla ei ole id-arvoa, näyttää editorissa ilmoituksen kenttiensä sijaan. PHPStan-laajennus ilmoittaa tästä kohteissa block.json ja field.json. Pidä rivin kentät samalla tasolla tai siirrä välilehdet toistimen ulkopuolelle.

WYSIWYG-linkkityökalurivi lisää oletusarvoisesti samaan välilehteen avautuvia linkkejä lisäämättä target– tai rel-määrityksiä. Ota uuteen välilehteen avaava vaihtoehto käyttöön asetuksella toolbar.formats.link.opensInNewTab:

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

Uuden välilehden valitseminen lisää määritykset target="_blank" ja rel="noreferrer noopener". Kun asetus poistetaan käytöstä, nämä automaattiset määritykset poistetaan. Jos haluat käyttää määrityksiä kentän kaikissa linkeissä, määritä toolbar.formats.link.attributes, esimerkiksi { "class": "content-link", "rel": "nofollow" }. Eksplisiittinen määritys säilytetään, ja uuteen välilehteen avaamisen turvallisuustunnisteet lisätään määritettyyn rel-arvoon.

URL-merkkijonon kirjoittaminen ei automaattisesti muuta sitä linkiksi, eikä kentässä olevan linkin napsauttaminen siirrä pois editorista. Aiemmin tallennetut linkkimääritykset säilyvät nykyisessä sisällössä; niitä ei siirretä automaattisesti.