Pereiti prie turinio

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.

JSON
{
  "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į.

JSON
{
  "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į.

JSON
{
  "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.

JSON
{
  "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ę.

JSON
{
  "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į.

JSON
{
  "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į.

JSON
{
  "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į.

JSON
{
  "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.

JSON
{
  "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į

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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ą.

Atvaizduoja nuorodos valdiklį vidinėms arba išorinėms nuorodoms pasirinkti.

JSON
{
  "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.

JSON
{
  "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ą.

JSON
{
  "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į.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "type": "tabs"
}

Savybės

Savybė Tipas Aprašymas
tabs array Rodomi skirtukai.

tekstas

Atvaizduoja vienos eilutės teksto įvesties lauką.

JSON
{
  "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ą.

JSON
{
  "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į.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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ų.

JSON
{
  "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
<?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ų.

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:

JSON
{
  "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.