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.
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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
{
"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ā.
{
"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.
{
"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.
{
"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. |
saite
Renderē saišu vadīklu, lai izvēlētos iekšējas vai ārējas saites.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"type": "tabs"
}
Rekvizīti
| Īpašība | Tips | Apraksts |
|---|---|---|
tabs |
array |
Rādāmās cilnes. |
teksts
Renderē vienas rindas teksta ievades lauku.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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 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 saites
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:
{
"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.