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ää.
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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
{
"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ä.
{
"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.
{
"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.
{
"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. |
linkki
Näyttää linkkiohjaimen sisäisten tai ulkoisten linkkien valintaan.
{
"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ä.
{
"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.
{
"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.
{
"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ä.
{
"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.
{
"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.
{
"type": "tabs"
}
Ominaisuudet
| Ominaisuus | Tyyppi | Kuvaus |
|---|---|---|
tabs |
array |
Näytettävät välilehdet. |
teksti
Näyttää yksirivisen tekstisyötekentän.
{
"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.
{
"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.
{
"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.
{
"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ä.
{
"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.
{
"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.
{
"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 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-linkit
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:
{
"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.