Laukų tipai
Blockstudio siūlo įvairių laukų tipų blokų sąsajoms kurti.
Projektai taip pat gali registruoti savo laukų tipus su vardų sritimi, naudodami
blockstudio/field_types. Rinkitės šį būdą, kai reikia naujo redaktoriaus valdiklio arba struktūruotos reikšmės. Rinkitės
custom/{name} laukus, kai reikia tik pakartotinai naudoti esamų laukų grupę.
Laukų šablonų receptų rinkinys
Praktiniai pavyzdžiai: sąlyginės grupės, išmanieji pasirinkimo laukai, kartotuvai ir užklausomis pasiekiama saugykla.
Bendrosios savybės
Toliau pateiktoje lentelėje išvardytos bendrosios savybės ir dažniausios reikšmių parinktys. default ir fallback palaikomos ten, kur nurodyta kiekvieno lauko tipo savybių lentelėje.
| Savybė | Tipas | Aprašymas |
|---|---|---|
id |
string | Unikalus atributo identifikatorius |
type |
string | Lauko tipas |
label |
string | Redaktoriuje rodoma etiketė |
description |
string | Po lauku rodomas aprašymo tekstas |
default |
mixed | Numatytoji lauko reikšmė |
fallback |
mixed | Atsarginė reikšmė, kai laukas tuščias |
help |
string | Pagalbos tekstas, rodomas kaip patarimas šalia etiketės |
hidden |
boolean | Paslėpti lauką nuo UI |
switch |
boolean | Rodyti perjungiklį, kuriuo galima išjungti lauką. Numatytoji reikšmė yra false. |
translate |
boolean | Nustatykite false, kad laukas nebūtų įtrauktas į WPML konfigūraciją |
conditions |
array | Sąlyginės logikos taisyklės |
Failų laukai su "returnFormat": "id" išsaugo importuotas nuorodas į eilutes, įskaitant pavienes reikšmes kartotiniuose laukuose. Neišspręstiems pavadinimams rodomos atsarginės kortelės be miniatiūrų; Blockstudio nesusieja jų su priedų ID. Daugiau informacijos žr. nešiojamųjų medijos nuorodų informacijoje.
Piktogramų parinkiklio užklausas, pakartotinius bandymus ir piktogramų poaibius rasite skiltyje Piktogramų įkėlimas.
attributes
Atvaizduoja duomenų atributo įvesties laukus.
{
"type": "attributes"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
array |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
array |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
link |
boolean |
Leidžia pasirinkti nuorodą iš išskleidžiamojo sąrašo. |
media |
boolean |
Leidžia pasirinkti mediją iš išskleidžiamojo sąrašo. |
blokas
Nurodo kitą Blockstudio bloką ir išplečia jo laukus eilutėje. Šablonuose reikšmė grąžina atvaizduotą bloko išvestį.
{
"type": "block"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
block |
string |
Nurodomo bloko pavadinimas (e.g., „mytheme/card“). |
returnFormat |
string |
Kaip reikšmė turėtų būti grąžinama šablonuose. |
žymimieji langeliai
Atvaizduoja žymimųjų langelių rinkinį.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
array | string | number |
Numatytoji reikšmė, kuri turėtų būti taikoma pirmą kartą pridedant bloką. |
fallback |
array | string | number |
Atsarginė reikšmė, kuri rodoma, kai lauko reikšmė tuščia. |
options |
array |
Pasirenkamos parinktys. |
returnFormat |
string |
Nurodo grąžinamos reikšmės formatą. |
populate |
object |
|
toggle |
boolean | string |
Virš parinkčių prideda žymimąjį langelį, kuriuo galima jas visas pažymėti arba panaikinti jų žymėjimą. Jo etiketei naudojama eilutė, o reikšmė true nustato numatytąją etiketę. |
klasės
Atvaizduoja lauką, skirtą CSS klasėms pasirinkti.
{
"type": "classes"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
tailwind |
boolean |
Ar įjungti Tailwind klases šiam įvesties laukui. |
kodas
Atvaizduoja kodo rengyklę.
{
"type": "code"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
autoCompletion |
boolean |
Ar įjungti automatinį užbaigimą. |
foldGutter |
boolean |
Ar rodyti lankstymo paraštę. |
height |
string |
Redaktoriaus aukštis. |
language |
string |
Sintaksės paryškinimo kalba. |
lineNumbers |
boolean |
Ar rodyti eilučių numerius. |
maxHeight |
string |
Didžiausias redaktoriaus aukštis. |
minHeight |
string |
Mažiausias redaktoriaus aukštis. |
popout |
boolean |
Ar rodyti mygtuką, kuriuo redaktorius atidaromas iššokančiame lange. |
asset |
boolean |
Atvaizduoja lauko CSS, SCSS arba JavaScript kaip bloko išteklių, todėl šablone nereikia išvesti stiliaus ar scenarijaus žymos. |
spalva
Atvaizduoja spalvų paletę ir spalvų parinkiklį.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Parinkties reikšmė, kuri turi būti pasirinkta pirmą kartą pridėjus bloką. |
fallback |
string |
Parinkties reikšmė, rodoma, kai lauko reikšmė tuščia. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Ar paletėje turi būti išvalymo mygtukas. |
disableCustomColors |
boolean |
Ar leisti pasirinktinę spalvą. |
data
Atvaizduoja datos parinkiklį.
{
"type": "date"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
startOfWeek |
number |
Savaitės pradžios diena. 0 reiškia sekmadienį, 1 – pirmadienį ir t. t. |
data ir laikas
Atvaizduoja datos ir laiko parinkiklį.
{
"type": "datetime"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
is12Hour |
boolean |
Ar naudoti 12 valandų laikrodžio formatą. Naudojant 12 valandų formatą, rodomas AM/PM valdiklis, o laiko formatas laikomas MM-DD-YYYY (vietoj numatytojo DD-MM-YYYY). |
failai
Atvaizduoja mygtuką, atveriantį medijos biblioteką. Pasirinktus elementus galima pertvarkyti neišeinant iš eilutės.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
array | object | number |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
array | object | number |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
addToGallery |
boolean |
Jei true, galerijos medijos modalas atidaromas tiesiai medijos bibliotekoje, kur naudotojas gali pridėti papildomų vaizdų. Jei false, galerijos medijos modalas atidaromas redagavimo režimu, kuriame galima redaguoti esamus vaizdus: pertvarkyti juos, pašalinti arba pakeisti jų atributus. Taikoma tik jei gallery === true. |
allowedTypes |
array | string |
Medijos tipų, kuriuos galima įkelti arba pasirinkti iš medijos bibliotekos, masyvas. Kiekvienas tipas yra eilutė, kurioje gali būti nurodytas bendras MIME tipas e.g: ‘image’, ‘audio’, ‘text’ arba visas MIME tipas e.g: ‘audio/mpeg’, ‘image/gif’. Jei allowedTypes nenustatytas, leidžiami visi MIME tipai. |
gallery |
boolean |
Jei true, komponentas inicijuoja visas būsenas, reikalingas galerijai atvaizduoti. Pagal numatytuosius nustatymus medijos modalas atidaromas galerijos redagavimo lange, tačiau tai galima pakeisti naudojant addToGalleryflag. |
max |
number |
Didžiausias galimų pridėti failų skaičius. |
min |
number |
Mažiausias galimų pridėti failų skaičius. |
multiple |
boolean |
Ar leisti pasirinkti kelis elementus. |
size |
boolean |
Prie lauko prideda medijos dydžio išskleidžiamąjį sąrašą. |
textMediaButton |
string |
Medijos mygtuko tekstas. |
title |
string |
Medijos modale rodomas pavadinimas. |
returnFormat |
string |
Nurodo grąžinamos reikšmės formatą. |
returnSize |
string |
Grąžinamas medijos dydis, kai naudojamas URL grąžinimo formatas. |
gradientas
Atvaizduoja gradientų paletę ir gradiento parinkiklį
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Parinkties reikšmė, kuri turi būti pasirinkta pirmą kartą pridėjus bloką. |
fallback |
string |
Parinkties reikšmė, rodoma, kai lauko reikšmė tuščia. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Ar paletėje turi būti išvalymo mygtukas. |
disableCustomGradients |
boolean |
Ar leisti pasirinktinę spalvą. |
grupė
Atvaizduoja kelis laukus (pasirinktinai) suskleidžiamame konteineryje.
{
"type": "group"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
title |
string |
Pavadinimo tekstas. Jis rodomas net uždarius komponentą. |
opened |
boolean |
Nustačius į true, komponentas liks atidarytas nepaisant pradinės initialOpen savybės ir |
initialOpen |
boolean |
Ar skydelis bus atidarytas pradžioje. |
scrollAfterOpen |
boolean |
Kai turinys tampa matomas, slenka prie jo. |
class |
string |
Pasirinktinė CSS klasė, taikoma grupei. |
style |
object |
Pasirinktiniai CSS stiliai, taikomi grupei. |
attributes |
array |
Priima visus kitus laukų tipus, išskyrus kitą skirtukų grupę. |
html-tag
Atvaizduoja HTML žymos parinkiklį. Naudinga renkantis antraštės lygius arba semantinius elementus.
{
"type": "html-tag"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
tags |
string | array |
Kokias žymas įtraukti. Naudokite iš anksto nustatytą eilutę arba žymų pavadinimų masyvą. |
exclude |
array |
Žymos, kurias reikia išskirti iš išankstinio rinkinio. Taikoma tik naudojant išankstinę žymų eilutę. |
piktograma
Atvaizduoja SVG piktogramą iš piktogramų rinkinio.
{
"type": "icon"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
object |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
object |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
sets |
array | string |
Kurį piktogramų rinkinį įtraukti. Palikite tuščią, kad būtų įtraukti visi. |
subSets |
array | string |
Kurį papildomą piktogramų rinkinį įtraukti. Palikite tuščią, kad būtų įtraukti visi. |
returnFormat |
string |
Kokiu formatu grąžinti piktogramą. |
nuoroda
Atvaizduoja nuorodos valdiklį vidinėms arba išorinėms nuorodoms pasirinkti.
{
"type": "link"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
object |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
object |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
hasRichPreviews |
boolean |
Ar pridedant URL rodyti raiškias peržiūras. |
noDirectEntry |
boolean |
Ar leisti paieškos užklausą, panašią į URL, tiesiogiai paversti nuoroda. |
noURLSuggestion |
boolean |
Ar pridėti atsarginį pasiūlymą, pagal kurį paieškos užklausa laikoma URL. |
opensInNewTab |
boolean |
Prie nuorodos modalinio lango prideda perjungimo valdiklį. |
showSuggestions |
boolean |
Ar rašant URL pateikti pasiūlymus. |
textButton |
string |
Pasirinktinis tekstas, rodomas nuorodos mygtuke. |
withCreateSuggestion |
boolean |
Ar neradus atitinkančios nuorodos paieškoje galima pasiūlyti sukurti naują juodraštinį puslapį. |
pranešimas
Atvaizduoja pranešimą su pasirinktiniu turiniu.
{
"type": "message"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
value |
string |
Rodomas pranešimas. Bloko ir atributo duomenys pasiekiami skliaustų sintakse, e.g.: {block.title} arba {attributes.text} |
skaičius
Atvaizduoja skaičiaus įvesties lauką.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
number |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
number |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
dragDirection |
string |
Nustato vilkimo ašį, kuria didinama arba mažinama reikšmė. |
dragThreshold |
number |
Jei isDragEnabled yra true, nustato, kiek px reikia vilkti, kad pasikeistų reikšmė. |
hideHTMLArrows |
boolean |
Jei true, paslepiamos numatytojo įvesties lauko HTML rodyklės. |
isShiftStepEnabled |
boolean |
Jei true, leidžia pelės vilkimo gestu didinti arba mažinti skaičiaus reikšmę. Vilkimo metu laikant SHIFT reikšmė didinama shiftStep dydžiu. |
max |
number |
Didžiausias reikšmės ilgis. |
min |
number |
Mažiausias reikšmės ilgis. |
required |
boolean |
Jei true, užtikrinama, kad skaičius būtų galiojantis ir patektų į valdiklio min/max intervalą. Jei false, tuščia eilutė laikoma galiojančia reikšme. |
shiftStep |
number |
Kiek didinti reikšmę laikant nuspaustą SHIFT klavišą. Ši reikšmė yra žingsnio reikšmės daugiklis. Pavyzdžiui, jei žingsnis yra 5, o shiftStep yra 10, kiekvienas šuolis reikšmę padidina arba sumažina 50. |
step |
number |
Kiek pakeisti reikšmę ją didinant arba mažinant. Tai taip pat naudojama tikrinant: reikšmė turi būti žingsnio kartotinis (atskaičius min, jei nurodyta), kad būtų galiojanti. Priima specialią eilutės reikšmę any, kuri panaikina tikrinimo apribojimą, o didinant ar mažinant po žingsnį reikšmė keičiama 1. |
akutės
Atvaizduoja jungiklių (radio) rinkinį.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string | number |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string | number |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
options |
array |
Galimos pasirinkti parinktys. |
returnFormat |
string |
Nurodo grąžinamos reikšmės formatą. |
populate |
object |
|
display |
string |
Nustatykite į buttonGroup, kad parinktys būtų rodomos kaip mygtukų grupė, o ne kaip vieno pasirinkimo įvesties laukai. |
allowNull |
boolean |
Leidžia naudotojui išvalyti reikšmę dar kartą spustelėjus pasirinktą vieno pasirinkimo įvesties lauką. |
diapazonas
Atvaizduoja diapazono įvestį, skirtą skaitinei reikšmei tarp dviejų taškų nustatyti.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
number |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
number |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
allowReset |
boolean |
Jei ši savybė yra true, atvaizduojamas slankiklio nustatymo iš naujo mygtukas. |
initialPosition |
number |
Pradinė slankiklio padėtis, naudojama, kai reikšmė nepateikiama. initialPosition apribojama nurodytomis min ir max savybių reikšmėmis. |
isShiftStepEnabled |
boolean |
Jei true, leidžia pelės vilkimo gestu didinti arba mažinti skaičiaus reikšmę. Vilkimo metu laikant SHIFT reikšmė didinama shiftStep dydžiu. |
marks |
array |
Atvaizduoja žingsnių žymų vaizdinį vaizdą. Pasirinktinius žymeklius galima pateikti masyvu. |
max |
number |
Didžiausias reikšmės ilgis. |
min |
number |
Mažiausias reikšmės ilgis. |
railColor |
string |
CSS spalvos eilutė, skirta bėgelio elemento fonui tinkinti. |
resetFallbackValue |
number |
Reikšmė, į kurią grįžtama paspaudus nustatymo iš naujo mygtuką (įjungiamas naudojant allowReset). |
separatorType |
string |
Nustato, ar valdiklių eilutės viršuje arba apačioje esanti skiriamoji linija turi būti paslėpta ar per visą plotį. Pagal numatytuosius nustatymus ji rodoma apačioje, išskyrus valdiklio piktogramos pabraukimą. |
shiftStep |
number |
Kiek didinti reikšmę laikant nuspaustą SHIFT klavišą. Ši reikšmė yra žingsnio reikšmės daugiklis. Pavyzdžiui, jei žingsnis yra 5, o shiftStep yra 10, kiekvienas šuolis reikšmę padidina arba sumažina 50. |
showTooltip |
boolean |
Priverstinai rodo arba slepia patarimą UI. Jei step nustatyta į specialią eilutės reikšmę any, ši parinktis perrašoma į false. |
step |
number |
Kiek pakeisti reikšmę ją didinant arba mažinant. Tai taip pat naudojama tikrinant: reikšmė turi būti žingsnio kartotinis (atskaičius min, jei nurodyta), kad būtų galiojanti. Priima specialią eilutės reikšmę any, kuri panaikina tikrinimo apribojimą, o didinant ar mažinant po žingsnį reikšmė keičiama 1. |
trackColor |
string |
CSS spalvos eilutė, skirta takelio elemento fonui tinkinti. |
withInputField |
boolean |
Nustato, ar skaičiaus įvesties laukas bus rodomas šalia RangeControl. Jei step nustatyta į specialią eilutės reikšmę any, ši parinktis perrašoma į false. |
pasirinkimas
Atvaizduoja pasirinkimo įvesties lauką, palaikantį vieną arba kelis pasirinkimus.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
array | string | number |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
array | string | number |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
multiple |
boolean |
Jei true, galima pasirinkti kelias parinktis. „stylisedUi“ įjungiama automatiškai. |
options |
array |
Galimos parinktys. |
returnFormat |
string |
Nurodo grąžinamos reikšmės formatą. |
populate |
object |
|
stylisedUi |
boolean |
Atvaizduoja stilizuotą pasirinkimo lauką, kuriame galima ieškoti elementų. |
allowNull |
boolean | string |
Leidžia pasirinkti tuščią parinktį. Jei true, etiketė bus tuščia, kitu atveju parinktyje bus rodoma nurodyta eilutė. |
allowReset |
boolean |
Jei ši savybė yra true, atvaizduojamas pasirinkimo nustatymo iš naujo mygtukas. |
skirtukai
Atvaizduoja sąsają su skirtukais laukams grupuoti.
{
"type": "tabs"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
tabs |
array |
Rodomi skirtukai. |
tekstas
Atvaizduoja vienos eilutės teksto įvesties lauką.
{
"type": "text",
"min": 0,
"max": 100
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
max |
number |
Didžiausias reikšmės ilgis. |
min |
number |
Mažiausias reikšmės ilgis. |
teksto sritis
Atvaizduoja teksto srities įvesties lauką.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
max |
number |
Didžiausias reikšmės ilgis. |
min |
number |
Mažiausias reikšmės ilgis. |
rows |
number |
Eilučių skaičius, kurį turėtų apimti teksto sritis. |
perjungiklis
Atvaizduoja true/false perjungiklį.
{
"type": "toggle"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
boolean |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
boolean |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
pasikartojantis laukas
Atvaizduoja laukų rinkinį, kurį galima kartoti.
{
"type": "repeater",
"min": 0,
"max": 100
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
array |
Eilutės, su kuriomis pradedamas naujas blokas. Kiekviena eilutė yra lauko reikšmių objektas. Turi pirmenybę prieš eilutes, kurias sukuria min. |
min |
number |
Mažiausias eilučių skaičius. |
max |
number |
Didžiausias eilučių skaičius. |
minimized |
boolean |
Suskleidžia esamas eilutes atidarius redaktorių. Redaktoriuje pridėtos eilutės išskleidžiamos. |
textButton |
string |
Pridėjimo mygtuko tekstas. |
textMinimized |
string | object |
Tekstas, rodomas sumažinus eilutes. |
textRemove |
string | boolean |
Patvirtinimo klausimas, rodomas redaktoriuje šalinant kartotuvo eilutę. Ne tuščia eilutė pakeičia klausimą; false pašalina eilutę iškart, nerodant dialogo. Jei reikšmė nenurodyta, yra true arba tuščia eilutė, naudojamas numatytasis klausimas. |
attributes |
array |
Priima visus kitus laukų tipus, išskyrus kitą skirtukų lauką. |
richtext
RichText laukų atributų laukas.
{
"type": "richtext"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
unit
Atvaizduoja skaičiaus įvesties lauką su vienetų išskleidžiamuoju sąrašu.
{
"type": "unit"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
disableUnits |
boolean |
Jei reikšmė yra true, vienetų pasirinkimo laukas paslepiamas. |
isPressEnterToChange |
boolean |
Jei reikšmė yra true, norint suaktyvinti onChange, reikia paspausti ENTER klavišą. Jei ši parinktis įjungta, pakeitimas taip pat suaktyvinamas perėjus į kitą lauką. |
isResetValueOnUnitChange |
boolean |
Jei reikšmė yra true, o pasirinktam vienetui nustatyta numatytoji reikšmė, keičiant vienetus ji priskiriama. |
isUnitSelectTabbable |
boolean |
Nustato, ar į vienetų pasirinkimo lauką galima pereiti naudojant Tab klavišą. |
units |
array |
wysiwyg
Atvaizduoja WYSIWYG redaktorių.
{
"type": "wysiwyg"
}
Savybės
| Savybė | Tipas | Aprašymas |
|---|---|---|
default |
string |
Numatytoji reikšmė, taikoma pirmą kartą pridėjus bloką. |
fallback |
string |
Atsarginė reikšmė, rodoma, kai lauko reikšmė tuščia. |
toolbar |
object |
Redaktoriaus įrankių juostos konfigūracija. |
mode |
string |
code atidaro lauką kodo rodinyje. both prideda mygtuką, kuriuo galima perjungti vaizdinį ir kodo rodinį. |
Piktogramų įkėlimas
Redaktorius įkelia piktogramų rinkinį, kai pirmą kartą fokusuojamas jo parinkiklis arba pakeičiamas rinkinys ar poaibis, o ne pasirinkus bloką. Laukai, kuriems reikia to paties rinkinio, naudoja tą pačią vykdomą užklausą. Išsaugotas piktogramos pavadinimas lieka matomas prieš įkėlimą, o pakartotinai sufokusavus parinkiklį, nepavykusi užklausa bandoma dar kartą.
tabler-icons palaiko outline ir filled. Aiškiai pasirinktam rinkiniui sukonfigūruotas poaibis turi pirmenybę; kitu atveju parinkiklis naudoja solid, jei jis pasiekiamas, arba pirmąjį rinkinio poaibį. Rinkiniai be poaibių praleidžia subSet.
Rinkinių pavadinimai susiejami tik su į rinkinį įtrauktais failais. Atvaizduojant sąsajoje saugomos atskiros piktogramos, o ne visi piktogramų rinkiniai duomenų bazės laikinuosiuose įrašuose.
Importuotos parinkčių reikšmės
Žymimieji langeliai ir išskleidžiamieji sąrašai su "multiple": true paprastai saugo { "value": "...", "label": "..." } objektų masyvą. Jie taip pat priima vieną parinkties objektą, eilutės arba skaičiaus skaliarinę reikšmę ar skaliarinių reikšmių masyvą, importuotą naudojant REST API arba turinio įrankius. Tai veikia ir kartotuvo eilutėse.
Redaktorius rodo šias reikšmes kaip pasirinktas, nepakeisdamas jų saugomos struktūros, jei nieko nekeičiančiu būdu išsaugoma. Pridėjus arba pašalinus pasirinkimą, įrašomas įprastas parinkčių objektų masyvas. Skaitinė 0 ir tekstinė "0" yra tinkamos pasirinktys.
Šablonams pateikiama sukonfigūruota lauko returnFormat, kaip ir reikšmėms, pasirinktoms redaktoriuje. Parinktys vis tiek turi atitikti deklaruotas arba užpildytas lauko pasirinktis.
Gimtasis vieno pasirinkimo sąrašas, kuriame nėra išsaugotos ar numatytosios reikšmės, rodo išjungtą tuščią vietaženklį, o ne pirmąją parinktį. Pasirinkus pirmąją parinktį, ji aiškiai įrašoma. Įrašius pasirinkimą, vietaženklis dingsta. Naudokite allowNull, kai redaktoriai taip pat turi galėti išvalyti pasirinkimą; tuščias vietaženklis neleidžia išvalyti pasirinkimo, kuris šiaip yra privalomas.
Pradinės kartotuvo eilutės
Redaktoriuje numatytosios reikšmės apima įdėtines minimalias eilutes dar prieš įterpimą. Nereikia atidaryti bloko nustatymų, kad jas inicijuotumėte, o įterpiant bloką šioms eilutėms nesukuriamas papildomas atšaukimo veiksmas.
Kai kartotiniame lauke yra min, bet nėra išsaugotos reikšmės ar aiškaus default, serveris inicijuoja tiek eilučių, kiek nurodyta, naudodamas eilučių laukų numatytąsias reikšmes. Tai taikoma ir PHP įterpiniams, blokų žymoms bei failuose saugomiems puslapių šaltiniams, kurie dar niekada nebuvo atverti redaktoriuje. Pavyzdžiui, "min": 2 su tekstiniu lauku, kurio numatytoji reikšmė yra "New item", pateikia dvi eilutes su ta reikšme.
Išsaugotos eilutės ir aiškiai nurodytas kartotuvo default nustatymas turi pirmenybę. Aiškiai išsaugotas tuščias sąrašas, false arba null neatkuria pašalintų eilučių. Atvaizduojant šios sugeneruotos numatytosios reikšmės atgal į įrašą neįrašomos. min ir max apriboja redaktoriaus valdiklius; atvaizduojant išsaugotas sąrašas nei sutrumpinamas, nei papildomas. Naudokite bs_validate_block() pranešti apie eilučių ribų pažeidimus importuotame turinyje.
Eilučių laukai be default sugeneruotoje eilutėje yra false, todėl tokioje eilutėje nėra turinio. Redaktorių pridėtos ir tuščios paliktos eilutės atrodo taip pat. Šablonas, kuriame kiekvienai eilutei pateikiama kortelė, antraštė ar sąrašo elementas, už redaktoriaus ribų turėtų praleisti eilutes be turinio, o redaktoriuje jas palikti, kad jų laukus būtų galima redaguoti:
<?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; ?>
Kartotinių laukų eilučių šalinimas
Pašalinus eilutę, redaktoriuje atidaromas patvirtinimo dialogo langas su mygtukais Delete ir Cancel. Pasirinkus Cancel arba paspaudus Escape, eilutė lieka nepakeista. Ji pašalinama tik patvirtinus, taip pat ir įdėtuose kartotiniuose laukuose.
textRemove valdo tą patį veikimą visuose kartotiniuose laukuose:
| Reikšmė | Veikimas |
|---|---|
Nenurodyta, true arba "" |
Rodyti numatytąjį patvirtinimo klausimą. |
| Netuščia eilutė | Rodyti šį pasirinktinį klausimą, naudojant esamą pasirinktinio teksto vertimo mechanizmą. |
false |
Pašalinti eilutę iškart, neatveriant dialogo. |
Pavyzdžiui, "textRemove": "Remove this team member?" pakeičia klausimą.
Esamas apribojimas min vis tiek neleidžia šalinti eilučių, kai jų skaičius nesiekia minimumo.
Kartotinių laukų įdėjimas
Kartotinio lauko eilutėje galima naudoti visų tipų laukus, išskyrus tabs. Jei eilutėje yra tabs laukas, net jei jis įdėtas į grupę be id, redaktoriuje vietoj jo laukų rodomas pranešimas. Plėtinys PHPStan apie tai praneša, kai naudojami block.json ir field.json. Eilutės laukus laikykite viename lygyje arba perkelkite skirtukus už kartotinio lauko ribų.
WYSIWYG nuorodos
Pagal numatytuosius nustatymus WYSIWYG nuorodų įrankių juosta įterpia nuorodas, atidaromas tame pačiame skirtuke, ir neprideda target ar rel. Naujo skirtuko parinktį įjunkite naudodami toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Pasirinkus naują skirtuką, pridedami target="_blank" ir rel="noreferrer noopener".
Išjungus šią parinktį, automatiškai pridedami atributai pašalinami. Jei norite taikyti atributus kiekvienai to lauko nuorodai, nustatykite toolbar.formats.link.attributes, pavyzdžiui,
{ "class": "content-link", "rel": "nofollow" }. Aiški konfigūracija išsaugoma, o konfigūruojamam rel pridedami saugumo žetonai, skirti naujam skirtukui.
Įvedus URL, nuoroda automatiškai nesukuriama, o spustelėjus esamą nuorodą lauke, iš redaktoriaus neišeinama. Anksčiau išsaugoti nuorodų atributai esamame turinyje išlieka; jie automatiškai nemigruojami.