Felttyper
Blockstudio tilbyder en række felttyper til opbygning af blokgrænseflader.
Projekter kan også registrere deres egne felttyper med navnerum ved hjælp af
blockstudio/field_types. Brug denne løsning,
når du har brug for en ny redigeringskontrol eller en struktureret værdiform. Brug
felter af typen custom/{name}, når du kun
har brug for at genbruge en gruppe eksisterende felter.
Praktiske opskrifter: betingede grupper, smarte valglister, repeatere og forespørgselsbaseret lagring.
Generelle egenskaber
Tabellen nedenfor viser fælles egenskaber og almindelige værdimuligheder. default og
fallback understøttes, hvor de er angivet i tabellen over egenskaber for hver felttype.
| Egenskab | Type | Beskrivelse |
|---|---|---|
id |
string | Entydig identifikator for attributten |
type |
string | Felttypen |
label |
string | Visningsetiket, der vises i editoren |
description |
string | Beskrivelsestekst, der vises under feltet |
default |
mixed | Standardværdi for feltet |
fallback |
mixed | Reserveværdi, når feltet er tomt |
help |
string | Hjælpetekst, der vises som et værktøjstip ved siden af etiketten |
hidden |
boolean | Skjul feltet i UI |
switch |
boolean | Vis en til/fra-knap, der kan deaktivere feltet. Standardværdien er false. |
translate |
boolean | Sæt til false for at udelade feltet fra konfigurationen WPML |
conditions |
array | Regler for betinget logik |
Filfelter med "returnFormat": "id" bevarer importerede strengreferencer,
herunder enkeltværdier i repeatere. Uafklarede navne viser reservekort
uden miniaturebilleder; Blockstudio omsætter dem ikke til vedhæftnings-ID’er. Se
bærbare mediehenvisninger for detaljer.
Se Indlæsning af ikoner for anmodninger fra vælgeren, nye forsøg og ikonundersæt.
attributes
Gengiver felter til indtastning af dataattributter.
{
"type": "attributes"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
array |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
array |
Reserveværdi, der vises, når feltværdien er tom. |
link |
boolean |
Gør det muligt at vælge et link fra en rullemenu. |
media |
boolean |
Gør det muligt at vælge medier fra en rullemenu. |
blok
Refererer til en anden Blockstudio-blok og udfolder dens felter direkte. I skabeloner returneres værdien som det renderede blokoutput.
{
"type": "block"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
block |
string |
Navnet på den blok, der skal refereres til (e.g., "mytheme/card"). |
returnFormat |
string |
Hvordan værdien skal returneres i skabeloner. |
afkrydsningsfelt
Viser et sæt afkrydsningsfelter.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
array | string | number |
Standardværdi, der skal anvendes, når blokken tilføjes første gang. |
fallback |
array | string | number |
Reserveværdi, der vises, når feltværdien er tom. |
options |
array |
Valgmuligheder. |
returnFormat |
string |
Angiver returværdiformatet. |
populate |
object |
|
toggle |
boolean | string |
Tilføjer et afkrydsningsfelt over valgmulighederne, som vælger eller fravælger dem alle. En streng bruges som dets etiket, og true bruger standardetiketten. |
klasser
Viser et felt til valg af CSS-klasser.
{
"type": "classes"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
tailwind |
boolean |
Om Tailwind-klasser skal aktiveres for dette inputfelt. |
kode
Viser en kodeeditor.
{
"type": "code"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, når blokken tilføjes første gang. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
autoCompletion |
boolean |
Om autofuldførelse skal aktiveres. |
foldGutter |
boolean |
Om foldningsmargen skal vises. |
height |
string |
Editorens højde. |
language |
string |
Det sprog, der skal bruges til synt fremhævning. |
lineNumbers |
boolean |
Om linjenumre skal vises. |
maxHeight |
string |
Editorens maksimale højde. |
minHeight |
string |
Editorens minimale højde. |
popout |
boolean |
Om der skal vises en knap, som åbner editoren i et pop op-vindue. |
asset |
boolean |
Gengiver CSS, SCSS eller JavaScript fra feltet som et blokaktiv, så skabelonen ikke behøver at udskrive style- eller script-tagget. |
farve
Viser en farvepalette og farvevælger.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Værdien af den indstilling, der skal vælges, når blokken tilføjes første gang. |
fallback |
string |
Værdien af den indstilling, der vises, når feltværdien er tom. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Om paletten skal have en knap til at rydde valget. |
disableCustomColors |
boolean |
Om brugerdefinerede farver skal tillades. |
dato
Viser en datovælger.
{
"type": "date"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
startOfWeek |
number |
Ugedagen, som ugen skal begynde på. 0 for søndag, 1 for mandag osv. |
dato og klokkeslæt
Viser en dato- og tidsvælger.
{
"type": "datetime"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
is12Hour |
boolean |
Om der bruges et 12-timers ur. Med et 12-timers ur vises en AM/PM-komponent, og tidsformatet antages at være MM-DD-YYYY (i modsætning til standardformatet DD-MM-YYYY). |
filer
Viser en knap til mediebiblioteket. Valgte elementer kan omarrangeres direkte.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
array | object | number |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
array | object | number |
Reserveværdi, der vises, når feltværdien er tom. |
addToGallery |
boolean |
Hvis true åbner galleriets mediedialog direkte i mediebiblioteket, hvor brugeren kan tilføje flere billeder. Hvis false åbner galleriets mediedialog i redigeringstilstand, hvor brugeren kan redigere eksisterende billeder ved at omarrangere dem, fjerne dem eller ændre deres attributter. Gælder kun, hvis gallery === true. |
allowedTypes |
array | string |
Array med de medietyper, der kan uploades eller vælges fra mediebiblioteket. Hver type er en streng, der kan indeholde den generelle MIME-type e.g: ‘image’, ‘audio’, ‘text’ eller den fulde MIME-type e.g: ‘audio/mpeg’, ‘image/gif’. Hvis allowedTypes ikke er angivet, tillades alle MIME-typer. |
gallery |
boolean |
Hvis true initialiserer komponenten alle de tilstande, der kræves for at repræsentere et galleri. Som standard åbnes mediedialogen i galleriets redigeringsvisning, men dette kan ændres med addToGalleryflag. |
max |
number |
Maksimalt antal filer, der kan tilføjes. |
min |
number |
Minimalt antal filer, der kan tilføjes. |
multiple |
boolean |
Om flere valg skal tillades. |
size |
boolean |
Føjer en rullemenu til valg af mediestørrelse til feltet. |
textMediaButton |
string |
Medieknappens tekst. |
title |
string |
Titel, der vises i mediedialogen. |
returnFormat |
string |
Angiver værdiformatet, der skal returneres. |
returnSize |
string |
Mediestørrelsen, der skal returneres ved brug af returformatet URL. |
farveovergang
Viser en farveovergangspalette og farveovergangsvælger
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Værdien af den indstilling, der skal vælges, når blokken tilføjes første gang. |
fallback |
string |
Værdien af den indstilling, der vises, når feltværdien er tom. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Om paletten skal have en knap til at rydde valget. |
disableCustomGradients |
boolean |
Om brugerdefinerede farver skal tillades. |
gruppe
Viser flere felter i en (valgfrit) sammenklappelig beholder.
{
"type": "group"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
title |
string |
Titeltekst. Den vises også, når komponenten er lukket. |
opened |
boolean |
Når værdien er true, forbliver komponenten åben uanset initialOpen-egenskaben og |
initialOpen |
boolean |
Om panelet skal være åbent fra start. |
scrollAfterOpen |
boolean |
Ruller indholdet ind i visningen, når det bliver synligt. |
class |
string |
Brugerdefineret CSS-klasse, der anvendes på gruppen. |
style |
object |
Brugerdefinerede CSS-stile, der anvendes på gruppen. |
attributes |
array |
Accepterer alle andre felttyper bortset fra en anden fanebladstype. |
html-tag
Viser en HTML-vælger. Nyttig til valg af overskriftsniveauer eller semantiske elementer.
{
"type": "html-tag"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
tags |
string | array |
Hvilke tags der skal medtages. Brug en forudindstillet streng eller et array med tagnavne. |
exclude |
array |
Tags, der skal udelades fra forudindstillingen. Gælder kun, når der bruges en forudindstillet streng til tags. |
ikon
Viser et SVG-ikon fra et ikonsæt.
{
"type": "icon"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
object |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
object |
Reserveværdi, der vises, når feltværdien er tom. |
sets |
array | string |
Hvilket ikonsæt der skal medtages. Lad feltet være tomt for at medtage alle. |
subSets |
array | string |
Hvilket underikonsæt der skal medtages. Lad feltet være tomt for at medtage alle. |
returnFormat |
string |
Formatet, ikonet skal returneres i. |
link
Viser en linkkontrol til valg af interne eller eksterne links.
{
"type": "link"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
object |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
object |
Reserveværdi, der vises, når feltværdien er tom. |
hasRichPreviews |
boolean |
Om der skal vises omfattende forhåndsvisninger, når der tilføjes et URL. |
noDirectEntry |
boolean |
Om en søgeforespørgsel i stil med URL direkte kan konverteres til et link. |
noURLSuggestion |
boolean |
Om der skal tilføjes et reserveforslag, som behandler søgeforespørgslen som en URL. |
opensInNewTab |
boolean |
Tilføjer en skifteknap til linkdialogen. |
showSuggestions |
boolean |
Om der skal vises forslag, mens der indtastes i URL. |
textButton |
string |
Brugerdefineret tekst, der skal vises i linkknappen. |
withCreateSuggestion |
boolean |
Om søgninger efter links uden match kan oprette et forslag til en ny kladdeside. |
meddelelse
Viser en meddelelse med brugerdefineret indhold.
{
"type": "message"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
value |
string |
Meddelelsen, der skal vises. Blok- og attributdata er tilgængelige med klammeparentessyntaks, e.g.: {block.title} eller {attributes.text} |
tal
Viser et talinputfelt.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
number |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
number |
Reserveværdi, der vises, når feltværdien er tom. |
dragDirection |
string |
Bestemmer trækaksen, der bruges til at øge eller mindske værdien. |
dragThreshold |
number |
Hvis isDragEnabled er true, angiver dette, hvor mange px der skal trækkes, før værdien ændres. |
hideHTMLArrows |
boolean |
Hvis true skjules standardpilene i inputfeltet HTML. |
isShiftStepEnabled |
boolean |
Hvis true aktiveres musebevægelsen, der øger eller mindsker talværdien. Hvis SHIFT holdes nede under træk, øges værdien med shiftStep. |
max |
number |
Den maksimale værdilængde. |
min |
number |
Minimal værdilængde. |
required |
boolean |
Hvis true kræves et gyldigt tal inden for kontrolfeltets min-/maksinterval. Hvis false accepteres en tom streng som gyldig værdi. |
shiftStep |
number |
Hvor meget værdien øges, når SHIFT-tasten holdes nede. Denne forskydningsværdi er en multiplikator for trinværdien. Hvis trinværdien f.eks. er 5, og shiftStep er 10, øges eller mindskes værdien med 50 for hvert spring. |
step |
number |
Hvor meget værdien ændres ved øgning eller mindskning. Det bruges også til validering, da værdien skal være et multiplum af step (forskudt med min, hvis angivet) for at være gyldig. Accepterer den særlige strengværdi any, som ophæver valideringsbegrænsningen og får trinhandlinger til at øge eller mindske værdien med 1. |
alternativknap
Viser et sæt alternativknapper.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string | number |
Standardværdi, der anvendes, når blokken tilføjes første gang. |
fallback |
string | number |
Reserveværdi, der vises, når feltværdien er tom. |
options |
array |
Mulige valgmuligheder. |
returnFormat |
string |
Angiver returværdiens format. |
populate |
object |
|
display |
string |
Sæt til buttonGroup for at vise valgmulighederne som en gruppe knapper i stedet for alternativknapper. |
allowNull |
boolean |
Giver brugeren mulighed for at rydde værdien ved at klikke på den valgte alternativknap igen. |
interval
Viser et intervalinputfelt til angivelse af en talværdi mellem to punkter.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
number |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
number |
Reserveværdi, der vises, når feltværdien er tom. |
allowReset |
boolean |
Hvis denne egenskab er true, vises en knap til nulstilling af skyderen. |
initialPosition |
number |
Skyderens startposition, der bruges, når der ikke er angivet nogen værdi. initialPosition begrænses til intervallet mellem de angivne min- og max-egenskabsværdier. |
isShiftStepEnabled |
boolean |
Hvis true aktiveres musebevægelsen, der øger eller mindsker talværdien. Hvis SHIFT holdes nede under træk, øges værdien med shiftStep. |
marks |
array |
Viser en visuel repræsentation af trintakmærker. Brugerdefinerede markører kan angives med et Array. |
max |
number |
Den maksimale værdilængde. |
min |
number |
Minimal værdilængde. |
railColor |
string |
CSS-farvestreng til tilpasning af skinnens baggrund. |
resetFallbackValue |
number |
Den værdi, der gendannes, hvis der klikkes på knappen Nulstil (aktiveret af allowReset) |
separatorType |
string |
Angiver, om skillelinjen over eller under kontrolrækken skal være deaktiveret eller have fuld bredde. Som standard placeres den under rækken, men dækker ikke kontrolikonets understregning. |
shiftStep |
number |
Hvor meget værdien øges, når SHIFT-tasten holdes nede. Denne forskydningsværdi er en multiplikator for trinværdien. Hvis trinværdien f.eks. er 5, og shiftStep er 10, øges eller mindskes værdien med 50 for hvert spring. |
showTooltip |
boolean |
Tvinger værktøjstipset UI til at blive vist eller skjult. Tilsidesættes med false, når step er angivet til den særlige strengværdi any. |
step |
number |
Hvor meget værdien ændres ved øgning eller mindskning. Det bruges også til validering, da værdien skal være et multiplum af step (forskudt med min, hvis angivet) for at være gyldig. Accepterer den særlige strengværdi any, som ophæver valideringsbegrænsningen og får trinhandlinger til at øge eller mindske værdien med 1. |
trackColor |
string |
CSS-farvestreng til tilpasning af sporets baggrund. |
withInputField |
boolean |
Afgør, om talinputfeltet vises ved siden af RangeControl. Tilsidesættes med false, når step er angivet til den særlige strengværdi any. |
valg
Viser et valgfelt med understøttelse af enkelt- og flervalg.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
array | string | number |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
array | string | number |
Reserveværdi, der vises, når feltværdien er tom. |
multiple |
boolean |
Hvis true kan flere muligheder vælges. "stylisedUi" aktiveres automatisk. |
options |
array |
Muligheder at vælge imellem. |
returnFormat |
string |
Angiver værdiformatet, der skal returneres. |
populate |
object |
|
stylisedUi |
boolean |
Viser en stiliseret version af et valgfelt med mulighed for at søge blandt elementerne. |
allowNull |
boolean | string |
Tillader brugeren at vælge en tom mulighed. Hvis true er etiketten tom; ellers vises den angivne streng som mulighed. |
allowReset |
boolean |
Hvis denne egenskab er true, vises en knap til nulstilling af valget. |
faner
Viser en grænseflade med faner til gruppering af felter.
{
"type": "tabs"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
tabs |
array |
Fanerne, der skal vises. |
tekst
Viser et enkeltlinjet tekstinputfelt.
{
"type": "text",
"min": 0,
"max": 100
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
max |
number |
Den maksimale værdilængde. |
min |
number |
Minimal værdilængde. |
tekstområde
Viser et tekstområde-inputfelt.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
max |
number |
Den maksimale værdilængde. |
min |
number |
Minimal værdilængde. |
rows |
number |
Antallet af rækker, tekstområdet skal indeholde. |
til/fra-knap
Viser en til/fra-knap for true/false.
{
"type": "toggle"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
boolean |
Standardværdi, der anvendes, første gang blokken tilføjes. |
fallback |
boolean |
Reserveværdi, der vises, når feltværdien er tom. |
gentager
Viser et sæt felter, der kan gentages.
{
"type": "repeater",
"min": 0,
"max": 100
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
array |
Rækker, som en ny blok starter med. Hver række er et objekt med feltværdier. Har forrang frem for de rækker, som min opretter. |
min |
number |
Mindste antal rækker. |
max |
number |
Største antal rækker. |
minimized |
boolean |
Skjul de eksisterende rækker, når editoren åbnes. Rækker, der tilføjes i editoren, starter udfoldede. |
textButton |
string |
Tekst på tilføj-knappen. |
textMinimized |
string | object |
Tekst, der vises, når rækkerne er minimeret. |
textRemove |
string | boolean |
Bekræftelsesspørgsmål, der vises i editoren, når en gentagerrække fjernes. En ikke-tom streng ændrer spørgsmålet; false fjerner rækken straks uden en dialog. Hvis værdien udelades, er true eller er en tom streng, bruges standards spørgsmålet. |
attributes |
array |
Accepterer alle andre felttyper end endnu et tabs-felt. |
richtext
Attributfelt til RichText-felter.
{
"type": "richtext"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, når blokken tilføjes første gang. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
unit
Viser et talfelt med en rullemenu til enheder.
{
"type": "unit"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, når blokken tilføjes første gang. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
disableUnits |
boolean |
Hvis værdien er true, skjules feltet til valg af enhed. |
isPressEnterToChange |
boolean |
Hvis værdien er true, skal der trykkes på ENTER for at udløse onChange. Hvis indstillingen er aktiveret, udløses en ændring også, når man tabber væk fra feltet. |
isResetValueOnUnitChange |
boolean |
Hvis værdien er true, og den valgte enhed har en standardværdi, angives denne værdi ved skift af enhed. |
isUnitSelectTabbable |
boolean |
Angiver, om feltet til valg af enhed kan fokuseres med tabulatortasten. |
units |
array |
wysiwyg
Viser en WYSIWYG-editor.
{
"type": "wysiwyg"
}
Egenskaber
| Egenskab | Type | Beskrivelse |
|---|---|---|
default |
string |
Standardværdi, der anvendes, når blokken tilføjes første gang. |
fallback |
string |
Reserveværdi, der vises, når feltværdien er tom. |
toolbar |
object |
Editorens værktøjslinjekonfiguration. |
mode |
string |
code åbner feltet i kodevisningen. both tilføjer en knap til at skifte mellem den visuelle visning og kodevisningen. |
Indlæsning af ikoner
Editoren indlæser et ikonsæt, når du fokuserer på vælgeren første gang eller ændrer sættet eller undersættet, ikke når du vælger blokken. Felter, der anmoder om det samme sæt, deler den igangværende anmodning. Det gemte ikonnavn forbliver synligt før indlæsning, og hvis du fokuserer på vælgeren igen, forsøges en mislykket anmodning igen.
tabler-icons understøtter outline og filled. Et undersæt, der er konfigureret specifikt til det valgte sæt, har forrang; ellers bruger vælgeren solid, hvis det er tilgængeligt, eller sættets første undersæt. Sæt uden undersæt udelader subSet.
Sætnavne slås kun op i medfølgende filer. Gengivelse på frontend cacher enkelte ikoner i stedet for at gemme hele ikonsæt i database-transienter.
Importerede indstillingsværdier
Afkrydsningsfelter og rullelister med "multiple": true gemmer normalt et array af { "value": "...", "label": "..." }-objekter. De accepterer også et enkelt indstillingsobjekt, en skalar streng eller et tal samt et array af skalare værdier, der importeres via REST API eller indholdsværktøjer. Dette fungerer også i gentagerrækker.
Editoren viser disse værdier som valg uden at omskrive deres lagrede struktur, når der gemmes uden ændringer. Hvis et valg tilføjes eller fjernes, gemmes værdierne som det sædvanlige array af indstillingsobjekter. Numeriske 0 og strengværdier "0" er gyldige valg.
Skabeloner modtager feltets konfigurerede returnFormat, ligesom de gør for værdier, der er valgt i editoren. Valgmulighederne skal stadig passe til feltets deklarerede eller udfyldte valg.
En indbygget rulleliste med ét valg og uden en gemt værdi eller standardværdi viser en deaktiveret tom pladsholder i stedet for sin første mulighed. Hvis den første mulighed vælges eksplicit, gemmes den. Når et valg er gemt, forsvinder pladsholderen. Brug allowNull, når redaktører også skal kunne rydde et valg; en tom pladsholder gør ikke i sig selv et obligatorisk valg muligt at rydde.
Gentagerens startrækker
I editoren omfatter standardværdier indlejrede minimumsrækker, før indsættelse. Du behøver ikke åbne blokkens indstillinger for at initialisere dem, og indsættelse af blokken tilføjer ikke et ekstra trin til fortrydelse for disse rækker.
Når et gentagelsesfelt har min, men ingen gemt værdi eller eksplicit default, initialiserer serveren så mange rækker med standardværdierne fra rækkernes felter. Dette gælder også for PHP-indlejringer, bloktags og filbaserede sidekilder, der aldrig er blevet åbnet i editoren. For eksempel gengiver "min": 2 med et tekstfelt, hvis standardværdi er "New item", to rækker, der indeholder den værdi.
Gemte rækker og en eksplicit gentagelsesværdi default har forrang. En eksplicit gemt tom liste, false eller null genskaber ikke fjernede rækker. Gengivelse gemmer ikke disse genererede standardværdier på indlægget. min og max begrænser editorens kontrolelementer; de afkorter eller udfylder ikke en gemt liste ved gengivelse. Brug bs_validate_block() til at rapportere overtrædelser af rækkebegrænsninger i importeret indhold.
Rækkefelter uden default er false i en genereret række, så sådan en række har intet indhold. Rækker, som redaktører tilføjer og lader stå tomme, ser ens ud. En skabelon, der udskriver et kort, en overskrift eller et listeelement for hver række, bør springe rækker uden indhold over uden for editoren og beholde dem i editoren, så deres felter fortsat kan redigeres:
<?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; ?>
Fjernelse af gentagelsesrækker
Når en række fjernes, åbnes editorens bekræftelsesdialog med knapperne Slet og Annuller. Annuller eller Escape lader rækken være uændret. Rækken fjernes først efter bekræftelse, også i indlejrede gentagelsesfelter.
textRemove styrer den samme adfærd for alle gentagelsesfelter:
| Værdi | Adfærd |
|---|---|
Udeladt, true eller "" |
Vis standardbekræftelsen. |
| En ikke-tom streng | Vis det tilpassede spørgsmål ved hjælp af den eksisterende mekanisme til oversættelse af tilpasset tekst. |
false |
Fjern rækken straks uden en dialog. |
For eksempel ændrer "textRemove": "Remove this team member?" spørgsmålet.
Den eksisterende begrænsning min forhindrer fortsat fjernelse af rækker under minimumsantallet.
Indlejring af gentagelsesfelter
En gentagelsesrække accepterer alle felttyper undtagen tabs. Et tabs-felt i en række, også inde i en gruppe uden en id, viser en meddelelse i editoren i stedet for sine felter. Udvidelsen PHPStan rapporterer det for block.json og field.json. Hold rækkens felter på samme niveau, eller flyt fanerne uden for gentagelsesfeltet.
WYSIWYG-links
WYSIWYG-linkværktøjslinjen indsætter som standard links, der åbnes i samme fane, uden at tilføje target eller rel. Aktivér indstillingen for nye faner med toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Når der vælges en ny fane, tilføjes target="_blank" og rel="noreferrer noopener".
Når indstillingen slås fra, fjernes disse automatiske attributter. Hvis du vil anvende attributter på alle links i feltet, skal du angive toolbar.formats.link.attributes, for eksempel
{ "class": "content-link", "rel": "nofollow" }. Eksplicit konfiguration bevares, og sikkerhedstokens for nye faner føjes til den konfigurerede rel.
En indtastet URL bliver ikke automatisk til et link, og et klik på et eksisterende link i feltet fører ikke væk fra editoren. Tidligere gemte linkattributter bevares i eksisterende indhold; de overføres ikke automatisk.