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.
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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. |
link
Kuvab juhtimiselementi, mille abil saab valida sise- või välislinke.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"type": "tabs"
}
Omadused
| Omadus | Tüüp | Kirjeldus |
|---|---|---|
tabs |
array |
Kuvatavad vahekaardid. |
tekst
Kuvab üherealise tekstisisendi.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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 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-lingid
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:
{
"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.