Pāriet uz saturu

Lauku tipi

Blockstudio nodrošina dažādus lauku tipus bloku saskarņu veidošanai.

Projekti var arī reģistrēt savus nosaukumvietā iekļautos lauku tipus ar blockstudio/field_types. Izmantojiet tos, ja nepieciešama jauna redaktora vadīkla vai strukturēta vērtība. Izmantojiet custom/{name} laukus, ja nepieciešams tikai atkārtoti izmantot esošu lauku grupu.

Lauku paraugu rokasgrāmata

Praktiski piemēri: nosacījumu grupas, viedās atlases, atkārtotāji un vaicājumos izmantojama krātuve.

Vispārīgie rekvizīti

Tālāk tabulā uzskaitīti koplietojamie rekvizīti un biežāk izmantotās vērtību opcijas. default un fallback tiek atbalstīti tur, kur tie norādīti katra lauka tipa rekvizītu tabulā.

Rekvizīts Tips Apraksts
id virkne Unikāls atribūta identifikators
type virkne Lauka tips
label virkne Redaktorā redzamā etiķete
description virkne Apraksta teksts zem lauka
default jaukts Lauka noklusējuma vērtība
fallback jaukts Rezerves vērtība, ja lauks ir tukšs
help virkne Palīdzības teksts, kas kā rīka padoms tiek rādīts pie etiķetes
hidden Būla vērtība Paslēpt lauku no UI
switch Būla vērtība Rādīt pārslēgu, ar ko lauku var atspējot. Noklusējuma vērtība ir false.
translate Būla vērtība Iestatiet uz false, lai lauku izlaistu no konfigurācijasWPML
conditions masīvs Nosacījuma loģikas noteikumi

Failu lauki ar "returnFormat": "id" saglabā importētās virkņu atsauces, tostarp atsevišķas vērtības atkārtotājos. Neatrisināti nosaukumi tiek rādīti kā rezerves kartītes bez sīktēliem; Blockstudio nepārvērš tos par pielikumu ID. Detalizētu informāciju skatiet sadaļā pārnesamas multivides atsauces.

Skatiet sadaļu Ikonu ielāde, lai uzzinātu par atlasītāja pieprasījumiem, atkārtotiem mēģinājumiem un ikonu apakškopām.

attributes

Attēlo datu atribūtu ievades laukus.

JSON
{
  "type": "attributes"
}

Rekvizīti

Īpašība Tips Apraksts
default array Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback array Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
link boolean Iespējo saišu izvēli nolaižamajā izvēlnē.
media boolean Iespējo multivides izvēli nolaižamajā izvēlnē.

bloks

Atsaucas uz citu Blockstudio bloku, izvēršot tā laukus iekļauti. Veidnēs vērtība atgriež renderēto bloka izvadi.

JSON
{
  "type": "block"
}

Rekvizīti

Īpašība Tips Apraksts
block string Atsaucamā bloka nosaukums (e.g., "mytheme/card").
returnFormat string Veidnēs atgriežamās vērtības veids.

izvēles rūtiņa

Renderē izvēles rūtiņu kopu.

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

Rekvizīti

Rekvizīts Tips Apraksts
default array | string | number Noklusējuma vērtība, kas jāiestata, pirmo reizi pievienojot bloku.
fallback array | string | number Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
options array Opcijas, no kurām izvēlēties.
returnFormat string Norāda atgriežamās vērtības formātu.
populate object
toggle boolean | string Pievieno virs opcijām izvēles rūtiņu, ar kuru var atlasīt vai noņemt atlasi visām opcijām. Tās etiķete ir virkne, bet, ja norādīta vērtība true, tiek izmantota noklusējuma etiķete.

klases

Renderē lauku, kurā atlasīt CSS klases.

JSON
{
  "type": "classes"
}

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
tailwind boolean Vai šim ievades laukam iespējot Tailwind klases.

kods

Renderē koda redaktoru.

JSON
{
  "type": "code"
}

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek rādīta, ja lauka vērtība ir tukša.
autoCompletion boolean Vai iespējot automātisko pabeigšanu.
foldGutter boolean Vai rādīt locīšanas joslu.
height string Redaktora augstums.
language string Sintakses izcelšanai izmantojamā valoda.
lineNumbers boolean Vai rādīt rindu numurus.
maxHeight string Redaktora maksimālais augstums.
minHeight string Redaktora minimālais augstums.
popout boolean Vai rādīt pogu, kas atver redaktoru uznirstošajā logā.
asset boolean Attēlo CSS, SCSS vai JavaScript no lauka kā bloka resursu, tāpēc veidnei nav jāizdrukā stila vai skripta tags.

krāsa

Renderē krāsu paleti un krāsu atlasītāju.

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

Rekvizīti

Īpašība Tips Apraksts
default string Opcijas vērtība, kas jāatlasa, pirmoreiz pievienojot bloku.
fallback string Opcijas vērtība, kas tiek rādīta, ja lauka vērtība ir tukša.
options array
populate object
clearable boolean Vai paletē jābūt pogai vērtības notīrīšanai.
disableCustomColors boolean Vai atļaut pielāgotu krāsu.

datums

Renderē datuma atlasītāju.

JSON
{
  "type": "date"
}

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
startOfWeek number Nedēļas sākuma diena. 0 apzīmē svētdienu, 1 — pirmdienu utt.

datums un laiks

Renderē datuma un laika atlasītāju.

JSON
{
  "type": "datetime"
}

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
is12Hour boolean Vai izmantot 12 stundu pulksteni. Šādā gadījumā tiek parādīts AM/PM logrīks, un tiek pieņemts laika formāts MM-DD-YYYY (pretstatā noklusējuma formātam DD-MM-YYYY).

faili

Renderē pogu, kas atver multivides bibliotēku. Atlasītos vienumus var pārkārtot uz vietas.

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

Rekvizīti

Īpašība Tips Apraksts
default array | object | number Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback array | object | number Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
addToGallery boolean Ja vērtība ir true, galerijas multivides modālais logs tiek atvērts tieši multivides bibliotēkā, kur lietotājs var pievienot attēlus. Ja vērtība ir false, galerijas multivides modālais logs tiek atvērts rediģēšanas režīmā, kur lietotājs var rediģēt esošos attēlus, tos pārkārtojot, noņemot vai mainot to atribūtus. Piemēro tikai tad, ja gallery === true.
allowedTypes array | string Masīvs ar multivides veidiem, ko augšupielādēt vai atlasīt multivides bibliotēkā. Katrs veids ir virkne, kas var saturēt vispārīgo MIME veidu e.g: ‘image’, ‘audio’, ‘text’ vai pilnu MIME veidu e.g: ‘audio/mpeg’, ‘image/gif’. Ja allowedTypes nav iestatīts, jāatļauj visi MIME veidi.
gallery boolean Ja vērtība ir true, komponents inicializē visus stāvokļus, kas nepieciešami galerijas attēlošanai. Pēc noklusējuma multivides modālais logs tiek atvērts galerijas rediģēšanas skatā, taču to var mainīt, izmantojot addToGalleryflag.
max number Maksimālais pievienojamo failu skaits.
min number Minimālais pievienojamo failu skaits.
multiple boolean Vai atļaut atlasīt vairākus vienumus.
size boolean Pievieno laukam multivides izmēra nolaižamo izvēlni.
textMediaButton string Multivides pogas teksts.
title string Multivides modālajā logā redzamais nosaukums.
returnFormat string Norāda atgriežamās vērtības formātu.
returnSize string Atgriežamais multivides izmērs, ja tiek izmantots URL atgriešanas formāts.

gradients

Renderē gradientu paleti un gradientu atlasītāju

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

Rekvizīti

Īpašība Tips Apraksts
default string Opcijas vērtība, kas jāatlasa, pirmoreiz pievienojot bloku.
fallback string Opcijas vērtība, kas tiek rādīta, ja lauka vērtība ir tukša.
options array
populate object
clearable boolean Vai paletē jābūt pogai vērtības notīrīšanai.
disableCustomGradients boolean Vai atļaut pielāgotu krāsu.

grupa

Renderē vairākus laukus (pēc izvēles) sakļaujamā konteinerā.

JSON
{
  "type": "group"
}

Rekvizīti

Īpašība Tips Apraksts
title string Virsraksta teksts. Tas ir redzams arī tad, kad komponents ir aizvērts.
opened boolean Ja iestatīts uz true, komponents paliks atvērts neatkarīgi no sākotnējās initialOpen īpašības un
initialOpen boolean Vai panelis sākotnēji būs atvērts.
scrollAfterOpen boolean Kad saturs kļūst redzams, ritina to skata apgabalā.
class string Pielāgota CSS klase, kas tiks lietota grupai.
style object Pielāgoti CSS stili, kas tiks lietoti grupai.
attributes array Pieņem visus pārējos lauku veidus, izņemot citu tabs.

html-tag

Renderē HTML tagu atlasītāju. Noder virsrakstu līmeņu vai semantisko elementu izvēlei.

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

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
tags string | array Kuras birkas iekļaut. Izmantojiet iepriekš iestatītu virkni vai birku nosaukumu masīvu.
exclude array Birkas, ko izslēgt no iepriekš iestatītā saraksta. Piemēro tikai tad, ja birkām izmanto iepriekš iestatītu virkni.

ikona

Renderē SVG ikonu no ikonu kopas.

JSON
{
  "type": "icon"
}

Rekvizīti

Īpašība Tips Apraksts
default object Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback object Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
sets array | string Iekļaujamā ikonu kopa. Atstājiet tukšu, lai iekļautu visas.
subSets array | string Iekļaujamā apakškopa. Atstājiet tukšu, lai iekļautu visas.
returnFormat string Ikonas atgriešanas formāts.

Renderē saišu vadīklu, lai izvēlētos iekšējas vai ārējas saites.

JSON
{
  "type": "link"
}

Rekvizīti

Īpašība Tips Apraksts
default object Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback object Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
hasRichPreviews boolean Vai, pievienojot URL, rādīt bagātinātos priekšskatījumus.
noDirectEntry boolean Vai atļaut meklēšanas vaicājumu URL tipa formā uzreiz pārvērst par saiti.
noURLSuggestion boolean Vai pievienot rezerves ieteikumu, kas meklēšanas vaicājumu uztver kā URL.
opensInNewTab boolean Pievieno saites modālajam logam pārslēgšanas vadīklu.
showSuggestions boolean Vai rakstot rādīt ieteikumus URL.
textButton string Pielāgots teksts, kas jārāda saites pogā.
withCreateSuggestion boolean Vai saites meklēšanā bez atbilstības var ieteikt izveidot jaunu melnraksta lapu.

ziņojums

Renderē ziņojumu ar pielāgotu saturu.

JSON
{
  "type": "message"
}

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
value string Rādāmais ziņojums. Bloka un atribūtu dati ir pieejami kvadrātiekavu sintaksē, e.g.: {block.title} vai {attributes.text}

skaitlis

Renderē skaitļa ievades lauku.

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

Rekvizīti

Īpašība Tips Apraksts
default number Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback number Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
dragDirection string Nosaka vilkšanas asi vērtības palielināšanai vai samazināšanai.
dragThreshold number Ja isDragEnabled ir true, šis iestata vilkšanas attālumu pikseļos, pirms mainās vērtība.
hideHTMLArrows boolean Ja true, noklusējuma ievades HTML bultiņas tiek paslēptas.
isShiftStepEnabled boolean Ja true, ar peles vilkšanu var palielināt vai samazināt skaitļa vērtību. Turot nospiestu SHIFT un velkot, vērtība palielinās par shiftStep.
max number Maksimālais vērtības garums.
min number Minimālais vērtības garums.
required boolean Ja true, nodrošina derīgu skaitli vadīklas min/max diapazonā. Ja false, tukša virkne tiek uzskatīta par derīgu vērtību.
shiftStep number Vērtības pieaugums, turot nospiestu SHIFT taustiņu. Šī nobīdes vērtība ir step vērtības reizinātājs. Piemēram, ja step vērtība ir 5 un shiftStep ir 10, katrs solis palielinās vai samazinās vērtību par 50.
step number Vērtības izmaiņas apjoms, to palielinot vai samazinot. To izmanto arī validācijā: vērtībai jābūt step daudzkārtnim (ar min nobīdi, ja tā norādīta), lai tā būtu derīga. Pieņem īpašo virknes vērtību any, kas atceļ validācijas ierobežojumu un katrā solī palielina vai samazina vērtību par 1.

radiopoga

Renderē radiopogu kopu.

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

Rekvizīti

Īpašība Tips Apraksts
default string | number Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string | number Rezerves vērtība, kas tiek rādīta, ja lauka vērtība ir tukša.
options array Pieejamās opcijas.
returnFormat string Norāda atgriežamās vērtības formātu.
populate object
display string Iestatiet uz buttonGroup, lai rādītu opcijas kā pogu grupu, nevis radio pogas.
allowNull boolean Ļauj lietotājam notīrīt vērtību, vēlreiz noklikšķinot uz atlasītās radio pogas.

diapazons

Renderē diapazona ievades vadīklu, lai iestatītu skaitlisku vērtību starp diviem punktiem.

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

Rekvizīti

Īpašība Tips Apraksts
default number Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback number Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
allowReset boolean Ja šīs īpašības vērtība ir true, tiek parādīta poga slīdņa atiestatīšanai.
initialPosition number Slīdņa sākuma pozīcija, ko izmanto, ja vērtība nav norādīta. initialPosition tiek ierobežota ar norādītajām min un max īpašību vērtībām.
isShiftStepEnabled boolean Ja true, ar peles vilkšanu var palielināt vai samazināt skaitļa vērtību. Turot nospiestu SHIFT un velkot, vērtība palielinās par shiftStep.
marks array Attēlo soļu atzīmes. Pielāgotus marķierus var norādīt kā masīvu.
max number Maksimālais vērtības garums.
min number Minimālais vērtības garums.
railColor string CSS krāsas virkne sliedes elementa fona pielāgošanai.
resetFallbackValue number Vērtība, pie kuras atgriezties, nospiežot atiestatīšanas pogu (iespējo allowReset).
separatorType string Nosaka, vai atdalošā līnija zem vai virs vadīklu rindas ir atspējota vai pilna platuma. Pēc noklusējuma tā atrodas zem rindas, nepasvītrojot vadīklas ikonu.
shiftStep number Vērtības pieaugums, turot nospiestu SHIFT taustiņu. Šī nobīdes vērtība ir step vērtības reizinātājs. Piemēram, ja step vērtība ir 5 un shiftStep ir 10, katrs solis palielinās vai samazinās vērtību par 50.
showTooltip boolean Piespiež Tooltip UI rādīt vai slēpt. Ja step ir iestatīts uz īpašo virknes vērtību any, šī vērtība tiek ignorēta un iestatīta uz false.
step number Vērtības izmaiņas apjoms, to palielinot vai samazinot. To izmanto arī validācijā: vērtībai jābūt step daudzkārtnim (ar min nobīdi, ja tā norādīta), lai tā būtu derīga. Pieņem īpašo virknes vērtību any, kas atceļ validācijas ierobežojumu un katrā solī palielina vai samazina vērtību par 1.
trackColor string CSS krāsas virkne sliedes elementa fona pielāgošanai.
withInputField boolean Nosaka, vai blakus RangeControl tiks rādīts skaitļa ievades lauks. Ja step ir iestatīts uz īpašo virknes vērtību any, šī vērtība tiek ignorēta un iestatīta uz false.

atlase

Renderē atlases ievades lauku, kas atbalsta viena vai vairāku vienumu izvēli.

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

Rekvizīti

Īpašība Tips Apraksts
default array | string | number Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback array | string | number Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
multiple boolean Ja true, var atlasīt vairākas iespējas. "stylisedUi" tiek iespējots automātiski.
options array Izvēles iespējas.
returnFormat string Norāda atgriežamās vērtības formātu.
populate object
stylisedUi boolean Renderē stilizētu atlases lauku ar iespēju meklēt vienumus.
allowNull boolean | string Ļauj lietotājam atlasīt tukšu izvēli. Ja true, etiķete būs tukša, pretējā gadījumā izvēlei tiks rādīta norādītā virkne.
allowReset boolean Ja šīs īpašības vērtība ir true, tiek parādīta poga atlases lauka atiestatīšanai.

cilnes

Renderē cilņu saskarni lauku grupēšanai.

JSON
{
  "type": "tabs"
}

Rekvizīti

Īpašība Tips Apraksts
tabs array Rādāmās cilnes.

teksts

Renderē vienas rindas teksta ievades lauku.

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

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
max number Maksimālais vērtības garums.
min number Minimālais vērtības garums.

teksta apgabals

Renderē teksta apgabala ievades lauku.

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

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.
max number Maksimālais vērtības garums.
min number Minimālais vērtības garums.
rows number Teksta apgabala rindu skaits.

pārslēgs

Renderē true/false pārslēgu.

JSON
{
  "type": "toggle"
}

Rekvizīti

Īpašība Tips Apraksts
default boolean Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback boolean Rezerves vērtība, kas tiek parādīta, ja lauka vērtība ir tukša.

atkārtotājs

Attēlo lauku kopu, ko var atkārtot.

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

Rekvizīti

Īpašība Tips Apraksts
default array Rindas, ar kurām sākas jauns bloks. Katra rinda ir lauku vērtību objekts. Tām ir prioritāte pār rindām, ko izveido min.
min number Minimālais rindu skaits.
max number Maksimālais rindu skaits.
minimized boolean Sakļauj esošās rindas, kad tiek atvērts redaktors. Redaktorā pievienotās rindas sākotnēji ir izvērstas.
textButton string Pievienošanas pogas teksts.
textMinimized string | object Teksts, kas tiek rādīts, kad rindas ir minimizētas.
textRemove string | boolean Apstiprinājuma jautājums, kas redaktorā tiek rādīts, noņemot atkārtotāja rindu. Netukša virkne maina jautājumu; false nekavējoties noņem rindu bez dialoga. Ja vērtība nav norādīta, ir true vai ir tukša virkne, tiek izmantots noklusējuma jautājums.
attributes array Atbalsta visus pārējos lauku tipus, izņemot citu ciļņu lauku.

richtext

RichText lauku atribūta lauks.

JSON
{
  "type": "richtext"
}

Rekvizīti

Īpašums Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek rādīta, ja lauka vērtība ir tukša.

unit

Attēlo skaitļa ievades lauku ar mērvienību nolaižamo sarakstu.

JSON
{
  "type": "unit"
}

Rekvizīti

Īpašums Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek rādīta, ja lauka vērtība ir tukša.
disableUnits boolean Ja vērtība ir true, mērvienības atlases lauks tiek paslēpts.
isPressEnterToChange boolean Ja vērtība ir true, lai aktivizētu onChange, jānospiež taustiņš ENTER. Ja šī opcija ir ieslēgta, izmaiņas tiek aktivizētas arī, pārejot uz citu lauku.
isResetValueOnUnitChange boolean Ja vērtība ir true un atlasītajai mērvienībai ir noklusējuma vērtība, mērvienības maiņas brīdī tiek iestatīta šī vērtība.
isUnitSelectTabbable boolean Nosaka, vai uz mērvienības atlases lauku var pāriet ar tabulēšanas taustiņu.
units array

wysiwyg

Attēlo WYSIWYG redaktoru.

JSON
{
  "type": "wysiwyg"
}

Rekvizīti

Īpašība Tips Apraksts
default string Noklusējuma vērtība, kas jāiestata, pirmoreiz pievienojot bloku.
fallback string Rezerves vērtība, kas tiek rādīta, ja lauka vērtība ir tukša.
toolbar object Redaktora rīkjoslas konfigurācija.
mode string code atver lauku koda skatā. both pievieno pogu pārslēgšanai starp vizuālo un koda skatu.

Ikonu ielāde

Redaktors ielādē ikonu kopu, kad pirmoreiz fokusējat tās atlasītāju vai maināt kopu vai apakškopu, nevis atlasot bloku. Lauki, kuriem nepieciešama viena un tā pati kopa, koplieto notiekošo pieprasījumu. Saglabātais ikonas nosaukums ir redzams jau pirms ielādes, un, atkārtoti fokusējot atlasītāju, neveiksmīgs pieprasījums tiek mēģināts vēlreiz.

tabler-icons atbalsta outline un filled. Apakškopai, kas ir skaidri konfigurēta izvēlētajai kopai, ir prioritāte; pretējā gadījumā atlasītājs izmanto solid, ja tā ir pieejama, vai kopas pirmo apakškopu. Kopām bez apakškopām subSet netiek iekļauts. Kopu nosaukumi tiek sasaistīti tikai ar komplektā iekļautajiem failiem. Priekšgala attēlošanā tiek kešotas atsevišķas ikonas, nevis pilnas ikonu kopas datubāzes pagaidu glabātuvē.

Importētās opciju vērtības

Izvēles rūtiņas un atlases lauki ar "multiple": true parasti saglabā objektu { "value": "...", "label": "..." } masīvu. Tie pieņem arī vienu opcijas objektu, skalāru virkni vai skaitli, kā arī skalāru vērtību masīvu, kas importēts, izmantojot REST API vai satura rīkus. Tas darbojas arī atkārtotāja rindās.

Redaktors šīs vērtības attēlo kā atlasītas, nepārrakstot to saglabāto struktūru, ja saglabāšanas laikā nekas nav mainīts. Pievienojot vai noņemot atlasi, tiek saglabāts parastais opciju objektu masīvs. Skaitliskas 0 un virknes "0" ir derīgas atlases. Veidnes saņem lauka konfigurēto returnFormat, tāpat kā gadījumā ar redaktorā atlasītajām vērtībām. Opcijām joprojām jāatbilst lauka deklarētajām vai aizpildītajām izvēles iespējām.

Ja vietējai vienas izvēles atlases izvēlnei nav saglabātas vērtības vai noklusējuma vērtības, tā rāda atspējotu tukšu vietturi, nevis pirmo opciju. Pirmās opcijas izvēle to saglabā. Kad izvēle ir saglabāta, vietturis pazūd. Izmantojiet allowNull, ja redaktoriem jāļauj arī notīrīt atlasi; tukšs vietturis neļauj notīrīt izvēli, kas citādi ir obligāta.

Atkārtotāja sākotnējās rindas

Redaktorā noklusējuma vērtības ietver ligzdotās minimālās rindas pirms ievietošanas. Lai tās inicializētu, nav jāatver bloka iestatījumi, un bloka ievietošana šīm rindām nepievieno otru atsaukšanas soli.

Ja atkārtotājs satur min, bet tam nav saglabātas vērtības vai skaidri norādīta default, serveris inicializē tik daudz rindu, cik norādīts, izmantojot rindu lauku noklusējuma vērtības. Tas attiecas arī uz PHP iegultajiem elementiem, bloku tagiem un no failiem ielādētiem lapu avotiem, kas redaktorā vēl nav atvērti. Piemēram, "min": 2 ar teksta lauku, kura noklusējuma vērtība ir "New item", attēlo divas rindas ar šo vērtību.

Saglabātajām rindām un skaidri norādītai atkārtotāja vērtībai default ir priekšroka. Skaidri saglabāts tukšs saraksts, false vai null neatjauno noņemtās rindas. Attēlošana nesaglabā šīs ģenerētās noklusējuma vērtības ziņā. min un max ierobežo redaktora vadīklas; tās attēlošanas laikā nesamazina un nepapildina saglabāto sarakstu. Izmantojiet bs_validate_block(), lai ziņotu par rindu skaita ierobežojumu pārkāpumiem importētā saturā.

Rindu lauki bez default ģenerētā rindā ir false, tāpēc šādai rindai nav satura. Tāpat izskatās arī redaktorā pievienotas un tukšas atstātas rindas. Veidnei, kas izvada kartīti, virsrakstu vai saraksta elementu katrai rindai, ārpus redaktora vajadzētu izlaist rindas bez satura, bet redaktorā tās paturēt, lai to laukus varētu rediģēt:

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

Atkārtotāja rindu noņemšana

Noņemot rindu, redaktorā tiek atvērts apstiprinājuma dialoglodziņš ar pogām Dzēst un Atcelt. Izvēloties Atcelt vai nospiežot Escape, rinda paliek nemainīga. Rinda tiek noņemta tikai pēc apstiprināšanas, arī ligzdotos atkārtotājos.

textRemove nosaka vienādu darbību visiem atkārtotājiem:

Vērtība Darbība
Izlaista, true vai "" Rāda noklusējuma apstiprinājuma jautājumu.
Virkne, kas nav tukša Rāda pielāgoto jautājumu, izmantojot esošo pielāgotā teksta tulkošanas mehānismu.
false Nekavējoties noņem rindu bez dialoglodziņa.

Piemēram, "textRemove": "Remove this team member?" maina jautājumu. Esošais ierobežojums min joprojām neļauj noņemt rindas, ja to skaits ir mazāks par minimālo.

Atkārtotāju ligzdošana

Atkārtotāja rinda pieņem visu veidu laukus, izņemot tabs. tabs lauks rindā, arī grupā bez id, redaktorā rāda paziņojumu, nevis savus laukus. Paplašinājums PHPStan par to ziņo pie block.json un field.json. Atstājiet rindas laukus vienā līmenī vai pārvietojiet cilnes ārpus atkārtotāja.

WYSIWYG saišu rīkjosla pēc noklusējuma ievieto saites, kas atveras tajā pašā cilnē, nepievienojot target vai rel. Iespējojiet atvēršanu jaunā cilnē ar toolbar.formats.link.opensInNewTab:

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

Izvēloties atvēršanu jaunā cilnē, tiek pievienoti target="_blank" un rel="noreferrer noopener". Izslēdzot šo opciju, šie automātiskie atribūti tiek noņemti. Lai piemērotu atribūtus visām saitēm šajā laukā, iestatiet toolbar.formats.link.attributes, piemēram, { "class": "content-link", "rel": "nofollow" }. Skaidri norādītā konfigurācija tiek saglabāta, un drošības tokeni saitēm, kas atveras jaunā cilnē, tiek pievienoti konfigurētajam rel.

Ierakstot URL, tas automātiski nekļūst par saiti, un, noklikšķinot uz esošas saites laukā, redaktors netiek aizvērts. Iepriekš saglabātie saišu atribūti esošajā saturā tiek saglabāti; tie netiek automātiski migrēti.