Fälttyper
Blockstudio innehåller flera olika fälttyper för att bygga blockgränssnitt.
Projekt kan också registrera egna fälttyper med namnområde via
blockstudio/field_types. Använd det när du behöver en ny redigeringskontroll eller en strukturerad värdestruktur. Använd
custom/{name}fält när du bara
behöver återanvända en grupp befintliga fält.
Praktiska recept: villkorsstyrda grupper, smarta urval, repeaters och frågebart lager.
Allmänna egenskaper
Tabellen nedan listar delade egenskaper och vanliga värdealternativ. default och fallback stöds där de anges i egenskapstabellen för varje fälttyp.
| Egenskap | Typ | Beskrivning |
|---|---|---|
id |
string | Unik identifierare för attributet |
type |
string | Fälttypen |
label |
string | Visningsetikett i redigeraren |
description |
string | Beskrivningstext som visas under fältet |
default |
mixed | Standardvärde för fältet |
fallback |
mixed | Reservvärde när fältet är tomt |
help |
string | Hjälptext som visas som ett verktygstips bredvid etiketten |
hidden |
boolean | Dölj fältet från UI |
switch |
boolean | Visa en växlingsknapp som kan inaktivera fältet. Standardvärdet är false. |
translate |
boolean | Ange false för att utelämna fältet från konfigurationen för WPML |
conditions |
array | Regler för villkorslogik |
Filfält med "returnFormat": "id" bevarar importerade strängreferenser, även enstaka värden i upprepningsfält. Olösta namn visas som reservkort utan miniatyrbilder; Blockstudio löser inte upp dem till bilage-ID:n. Mer information finns i portabla medierreferenser.
Se Laddning av ikoner för förfrågningar från väljaren, nya försök och ikonuppsättningar.
attributes
Återger indatafält för dataattribut.
{
"type": "attributes"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
array |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
array |
Reservvärde som visas när fältvärdet är tomt. |
link |
boolean |
Aktiverar länkval i en rullgardinsmeny. |
media |
boolean |
Aktiverar medieval i en rullgardinsmeny. |
block
Refererar till ett annat Blockstudio-block och visar dess fält direkt. I mallar returnerar värdet den renderade blockutdata.
{
"type": "block"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
block |
string |
Namnet på blocket som ska refereras till (e.g., "mytheme/card"). |
returnFormat |
string |
Hur värdet ska returneras i mallar. |
checkbox
Renderar en uppsättning kryssrutor.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
array | string | number |
Standardvärde som ska tillämpas när blocket läggs till första gången. |
fallback |
array | string | number |
Reservvärde som visas när fältvärdet är tomt. |
options |
array |
Alternativ att välja mellan. |
returnFormat |
string |
Anger returformatets värde. |
populate |
object |
|
toggle |
boolean | string |
Lägger till en kryssruta ovanför alternativen som markerar eller avmarkerar alla. En sträng används som etikett; ⟦I0:⟧true använder standardetiketten. |
classes
Renderar ett fält för att välja CSS-klasser.
{
"type": "classes"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
tailwind |
boolean |
Om Tailwind-klasser ska aktiveras för det här inmatningsfältet. |
code
Renderar en kodredigerare.
{
"type": "code"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som ska användas när blocket läggs till för första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
autoCompletion |
boolean |
Om automatisk komplettering ska aktiveras eller inte. |
foldGutter |
boolean |
Om utfällningsmarginalen ska visas eller inte. |
height |
string |
Editorns höjd. |
language |
string |
Språket som ska användas för syntaxmarkering. |
lineNumbers |
boolean |
Om radnummer ska visas eller inte. |
maxHeight |
string |
Editorns maximala höjd. |
minHeight |
string |
Editorns minsta höjd. |
popout |
boolean |
Om en knapp som öppnar editorn i ett popupfönster ska visas eller inte. |
asset |
boolean |
Renderar CSS, SCSS eller JavaScript från fältet som en blockresurs, så att mallen inte behöver skriva ut stil- eller skripttaggen. |
color
Renderar en färgpalett och färgväljare.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Värdet på alternativet som ska vara valt när blocket läggs till för första gången. |
fallback |
string |
Värdet på alternativet som visas när fältvärdet är tomt. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Om paletten ska ha en knapp för att rensa valet eller inte. |
disableCustomColors |
boolean |
Om anpassade färger ska tillåtas eller inte. |
date
Renderar en datumväljare.
{
"type": "date"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
startOfWeek |
number |
Vilken veckodag veckan ska börja på. 0 för söndag, 1 för måndag osv. |
datetime
Renderar en datum- och tidsväljare.
{
"type": "datetime"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
is12Hour |
boolean |
Om en 12-timmarsklocka ska användas. Med en 12-timmarsklocka visas en AM/PM-kontroll och tidsformatet antas vara MM-DD-YYYY (i stället för standardformatet DD-MM-YYYY). |
files
Renderar en knapp till mediebiblioteket. Valda objekt kan ordnas om direkt.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
array | object | number |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
array | object | number |
Reservvärde som visas när fältvärdet är tomt. |
addToGallery |
boolean |
Om värdet är true öppnas galleriets mediedialog direkt i mediebiblioteket, där användaren kan lägga till fler bilder. Om värdet är false öppnas galleriets mediedialog i redigeringsläget, där användaren kan redigera befintliga bilder genom att ordna om dem, ta bort dem eller ändra deras attribut. Gäller endast om gallery === true. |
allowedTypes |
array | string |
Array med medietyper som kan laddas upp eller väljas i mediebiblioteket. Varje typ är en sträng som kan innehålla den allmänna MIME-typen e.g: ‘image’, ‘audio’, ‘text’ eller den fullständiga MIME-typen e.g: ‘audio/mpeg’, ‘image/gif’. Om allowedTypes inte har angetts tillåts alla MIME-typer. |
gallery |
boolean |
Om värdet är true initierar komponenten alla tillstånd som behövs för att representera ett galleri. Som standard öppnas mediedialogen i galleriets redigeringsvy, men detta kan ändras med flaggan addToGalleryflag. |
max |
number |
Högsta antalet filer som kan läggas till. |
min |
number |
Minsta antalet filer som kan läggas till. |
multiple |
boolean |
Om flera objekt får väljas. |
size |
boolean |
Lägger till en rullgardinsmeny för mediestorlek i fältet. |
textMediaButton |
string |
Medieknappens text. |
title |
string |
Titeln som visas i mediedialogen. |
returnFormat |
string |
Anger returformatet. |
returnSize |
string |
Mediestorleken som ska returneras när returformatet URL används. |
gradient
Renderar en gradientpalett och gradientväljare
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Värdet på alternativet som ska vara valt när blocket läggs till för första gången. |
fallback |
string |
Värdet på alternativet som visas när fältvärdet är tomt. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Om paletten ska ha en knapp för att rensa valet eller inte. |
disableCustomGradients |
boolean |
Om anpassade färger ska tillåtas eller inte. |
group
Renderar flera fält i en (valfritt) hopfällbar behållare.
{
"type": "group"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
title |
string |
Titeltext. Den visas även när komponenten är stängd. |
opened |
boolean |
När värdet är true förblir komponenten öppen oavsett värdet på egenskapen initialOpen och |
initialOpen |
boolean |
Om panelen ska vara öppen från början. |
scrollAfterOpen |
boolean |
Rullar innehållet till synligt område när det blir synligt. |
class |
string |
Anpassad CSS-klass som tillämpas på gruppen. |
style |
object |
Anpassade CSS-stilar som tillämpas på gruppen. |
attributes |
array |
Godtar alla andra fälttyper utom ytterligare en flik. |
html-tag
Renderar en HTML-väljare. Användbar för att välja rubriknivåer eller semantiska element.
{
"type": "html-tag"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
tags |
string | array |
Vilka taggar som ska inkluderas. Använd en förinställd sträng eller en array med taggnamn. |
exclude |
array |
Taggar som ska uteslutas från förinställningen. Gäller endast när en förinställd sträng används för taggar. |
icon
Renderar en SVG-ikon från en ikonuppsättning.
{
"type": "icon"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
object |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
object |
Reservvärde som visas när fältvärdet är tomt. |
sets |
array | string |
Vilken ikonuppsättning som ska inkluderas. Lämna tomt för att inkludera alla. |
subSets |
array | string |
Vilken underordnad ikonuppsättning som ska inkluderas. Lämna tomt för att inkludera alla. |
returnFormat |
string |
I vilket format ikonen ska returneras. |
link
Renderar en länkfunktion för att välja interna eller externa länkar.
{
"type": "link"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
object |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
object |
Reservvärde som visas när fältvärdet är tomt. |
hasRichPreviews |
boolean |
Om avancerade förhandsvisningar ska visas när en URL läggs till. |
noDirectEntry |
boolean |
Om en sökfråga av typen URL direkt ska kunna omvandlas till en länk. |
noURLSuggestion |
boolean |
Om ett reservförslag ska läggas till som behandlar sökfrågan som en URL. |
opensInNewTab |
boolean |
Lägger till en växlingskontroll i länkdialogen. |
showSuggestions |
boolean |
Om förslag ska visas när URL skrivs in. |
textButton |
string |
Anpassad text som ska visas i länkknappen. |
withCreateSuggestion |
boolean |
Om omatchade länksökningar kan skapa ett förslag på en ny utkastssida. |
message
Renderar ett meddelande med anpassat innehåll.
{
"type": "message"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
value |
string |
Meddelandet som ska visas. Block- och attributdata är tillgängliga med hakparentessyntax, e.g: {block.title} eller {attributes.text} |
number
Renderar ett numeriskt inmatningsfält.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
number |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
number |
Reservvärde som visas när fältvärdet är tomt. |
dragDirection |
string |
Anger dragriktningen för att öka eller minska värdet. |
dragThreshold |
number |
Om isDragEnabled är true anger detta hur många px som måste dras innan värdet ändras. |
hideHTMLArrows |
boolean |
Om värdet är true döljs pilarna i standardinmatningens HTML. |
isShiftStepEnabled |
boolean |
Om värdet är true aktiveras en musgest för att dra och öka eller minska siffervärdet. Om du håller ned SHIFT medan du drar ökas värdet med shiftStep. |
max |
number |
Siffervärdets maximala längd. |
min |
number |
Siffervärdets minsta längd. |
required |
boolean |
Om värdet är true framtvingas ett giltigt tal inom kontrollens min/max-intervall. Om värdet är false tillåts en tom sträng som giltigt värde. |
shiftStep |
number |
Hur mycket värdet ökas med när SHIFT-tangenten hålls ned. Detta skiftvärde är en multiplikator för steg-värdet. Om steg-värdet till exempel är 5 och shiftStep är 10 ökar eller minskar varje hopp värdet med 50. |
step |
number |
Hur mycket värdet ändras vid ökning eller minskning. Detta används också vid validering: värdet måste vara en multipel av step (förskjutet med min, om det anges) för att vara giltigt. Godtar specialsträngvärdet any, som upphäver valideringsvillkoret och gör att stegvisa åtgärder ökar eller minskar värdet med 1. |
radio
Renderar en uppsättning alternativknappar.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string | number |
Standardvärde som ska användas när blocket läggs till för första gången. |
fallback |
string | number |
Reservvärde som visas när fältvärdet är tomt. |
options |
array |
Alternativ att välja mellan. |
returnFormat |
string |
Anger returformatets värde. |
populate |
object |
|
display |
string |
Ange buttonGroup för att visa alternativen som en grupp med knappar i stället för radioalternativ. |
allowNull |
boolean |
Gör det möjligt för användaren att rensa värdet genom att klicka på det valda radioalternativet igen. |
range
Renderar ett intervallfält för att ange ett numeriskt värde mellan två punkter.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
number |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
number |
Reservvärde som visas när fältvärdet är tomt. |
allowReset |
boolean |
Om den här egenskapen är true renderas en knapp för att återställa reglaget. |
initialPosition |
number |
Reglagets startposition, som används när inget värde anges. initialPosition begränsas till värdena för egenskaperna min och max. |
isShiftStepEnabled |
boolean |
Om värdet är true aktiveras en musgest för att dra och öka eller minska siffervärdet. Om du håller ned SHIFT medan du drar ökas värdet med shiftStep. |
marks |
array |
Renderar en visuell representation av stegmarkeringar. Anpassade markörer kan anges med en array. |
max |
number |
Siffervärdets maximala längd. |
min |
number |
Siffervärdets minsta längd. |
railColor |
string |
CSS-färgsträng för att anpassa skenelementets bakgrund. |
resetFallbackValue |
number |
Värdet som återställs till om knappen Reset klickas (aktiveras med allowReset). |
separatorType |
string |
Anger om avdelarlinjen ovanför eller under kontrollraden ska inaktiveras eller vara fullbredd. Som standard placeras den nedanför och lämnar kontrollikonen utan understrykning. |
shiftStep |
number |
Hur mycket värdet ökas med när SHIFT-tangenten hålls ned. Detta skiftvärde är en multiplikator för steg-värdet. Om steg-värdet till exempel är 5 och shiftStep är 10 ökar eller minskar varje hopp värdet med 50. |
showTooltip |
boolean |
Tvingar verktygstipset UI att visas eller döljas. Detta åsidosätts till false när step har specialsträngvärdet any. |
step |
number |
Hur mycket värdet ändras vid ökning eller minskning. Detta används också vid validering: värdet måste vara en multipel av step (förskjutet med min, om det anges) för att vara giltigt. Godtar specialsträngvärdet any, som upphäver valideringsvillkoret och gör att stegvisa åtgärder ökar eller minskar värdet med 1. |
trackColor |
string |
CSS-färgsträng för att anpassa spårelementets bakgrund. |
withInputField |
boolean |
Anger om sifferfältet ska renderas bredvid RangeControl. Detta åsidosätts till false när step har specialsträngvärdet any. |
select
Renderar ett urvalsfält med stöd för att välja ett eller flera alternativ.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
array | string | number |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
array | string | number |
Reservvärde som visas när fältvärdet är tomt. |
multiple |
boolean |
Om värdet är true kan flera alternativ väljas. "stylisedUi" aktiveras automatiskt. |
options |
array |
Alternativ att välja mellan. |
returnFormat |
string |
Anger returformatet. |
populate |
object |
|
stylisedUi |
boolean |
Renderar en stiliserad version av ett urvalsfält med möjlighet att söka bland objekten. |
allowNull |
boolean | string |
Låter användaren välja ett tomt alternativ. Om värdet är true är etiketten tom, annars renderas det angivna alternativet som sträng. |
allowReset |
boolean |
Om den här egenskapen är true renderas en knapp för att återställa urvalet. |
tabs
Renderar ett gränssnitt med flikar för att gruppera fält.
{
"type": "tabs"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
tabs |
array |
Flikarna som ska visas. |
text
Renderar ett inmatningsfält för text på en rad.
{
"type": "text",
"min": 0,
"max": 100
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
max |
number |
Textvärdets maximala längd. |
min |
number |
Textvärdets minsta längd. |
textarea
Renderar ett textområdesfält.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
max |
number |
Textvärdets maximala längd. |
min |
number |
Textvärdets minsta längd. |
rows |
number |
Antalet rader som textområdet ska innehålla. |
toggle
Renderar en true/false-växel.
{
"type": "toggle"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
boolean |
Standardvärde som tillämpas när blocket läggs till första gången. |
fallback |
boolean |
Reservvärde som visas när fältvärdet är tomt. |
repeater
Renderar en uppsättning fält som kan upprepas.
{
"type": "repeater",
"min": 0,
"max": 100
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
array |
Rader som ett nytt block börjar med. Varje rad är ett objekt med fältvärden. Har företräde framför det antal rader som min skapar. |
min |
number |
Minsta antal rader. |
max |
number |
Högsta antal rader. |
minimized |
boolean |
Fäll ihop befintliga rader när editorn öppnas. Rader som läggs till i editorn visas utfällda. |
textButton |
string |
Text på knappen för att lägga till. |
textMinimized |
string | object |
Text som visas när rader är minimerade. |
textRemove |
string | boolean |
Bekräftelsefråga som visas i editorn när en upprepningsrad tas bort. En icke-tom sträng ändrar frågan; false tar bort raden direkt utan en dialogruta. Om värdet utelämnas, är true eller är en tom sträng används standardfrågan. |
attributes |
array |
Godtar alla andra fälttyper utom ytterligare en tabs. |
richtext
Attributfält för RichText-fält.
{
"type": "richtext"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som ska användas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
unit
Renderar ett nummerfält med en enhetsmeny.
{
"type": "unit"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som ska användas när blocket läggs till första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
disableUnits |
boolean |
Om värdet är true döljs fältet för val av enhet. |
isPressEnterToChange |
boolean |
Om värdet är true krävs ett tryck på ENTER för att utlösa onChange. Om det är aktiverat utlöses en ändring även när man tabbar vidare. |
isResetValueOnUnitChange |
boolean |
Om värdet är true och den valda enheten har ett standardvärde, anges detta värde när enheten ändras. |
isUnitSelectTabbable |
boolean |
Anger om fältet för val av enhet kan nås med tabbtangenten. |
units |
array |
wysiwyg
Renderar en WYSIWYG-redigerare.
{
"type": "wysiwyg"
}
Egenskaper
| Egenskap | Typ | Beskrivning |
|---|---|---|
default |
string |
Standardvärde som ska användas när blocket läggs till för första gången. |
fallback |
string |
Reservvärde som visas när fältvärdet är tomt. |
toolbar |
object |
Editorns verktygsfältskonfiguration. |
mode |
string |
code öppnar fältet i kodvyn. both lägger till en knapp för att växla mellan den visuella vyn och kodvyn. |
Ikonladdning
Editorn laddar en ikonuppsättning första gången du fokuserar på dess väljare eller ändrar uppsättningen eller deluppsättningen, inte när du väljer blocket. Fält som begär samma uppsättning delar på den pågående begäran. Det sparade ikonnamnet visas innan laddningen, och om väljaren fokuseras igen görs ett nytt försök efter ett misslyckat anrop.
tabler-icons har stöd för outline och filled. En deluppsättning som uttryckligen har konfigurerats för den valda uppsättningen har företräde; annars använder väljaren solid om den är tillgänglig, eller uppsättningens första deluppsättning. Uppsättningar utan deluppsättningar utelämnar subSet. Uppsättningsnamn matchas endast mot medföljande filer. Frontend-rendering cachelagrar enskilda ikoner i stället för att lagra hela ikonuppsättningar i tillfälliga databasposter.
Importerade alternativvärden
Kryssrutor och väljare med "multiple": true lagrar vanligtvis en array med { "value": "...", "label": "..." }-objekt. De godtar även ett enskilt alternativobjekt, en skalär sträng eller ett tal, eller en array med skalärvärden som importerats via REST API eller innehållsverktyg. Detta fungerar även i upprepningsrader.
Editorn visar dessa värden som val utan att skriva om deras lagrade format när inget har ändrats. Om ett val läggs till eller tas bort lagras i stället den vanliga arrayen med alternativobjekt. Numeriska 0 och strängbaserade "0" är giltiga val. Mallar får fältets konfigurerade returnFormat, precis som för värden som valts i editorn. Alternativen måste fortfarande motsvara fältets angivna eller ifyllda val.
En inbyggd väljare för ett enda alternativ utan lagrat värde eller standardvärde visar en inaktiverad tom platshållare, inte sitt första alternativ. Om det första alternativet väljs uttryckligen lagras det. När ett val har lagrats försvinner platshållaren. Använd allowNull när redaktörer också ska kunna rensa ett val; en tom platshållare gör inte ett annars obligatoriskt val rensningsbart.
Upprepningens startrader
I editorn ingår kapslade minimiantal rader bland standardvärdena före infogning. Du behöver inte öppna blockets inställningar för att initiera dem, och när blocket infogas skapas inget extra ångra-steg för raderna.
När en repeater har min men inget sparat värde eller explicit default initierar servern det antalet rader med radfältens standardvärden. Detta gäller även PHP-inbäddningar, blocktaggar och filbaserade sidkällor som aldrig har öppnats i redigeraren. Om till exempel "min": 2 har ett textfält med standardvärdet "New item" återges två rader som innehåller det värdet.
Sparade rader och en uttrycklig repeater default har företräde. En uttryckligen sparad tom lista, false eller null återskapar inte borttagna rader. Vid rendering skrivs dessa genererade standardvärden inte tillbaka till inlägget. min och max begränsar redigerarens kontroller; de trunkerar eller fyller inte ut en sparad lista vid rendering. Använd bs_validate_block() för att rapportera överträdelser av radgränser i importerat innehåll.
Radfält utan default är false i en genererad rad, så en sådan rad har inget innehåll. Rader som redigerare lägger till och lämnar tomma ser likadana ut. En mall som skriver ut ett kort, en rubrik eller ett listobjekt för varje rad bör hoppa över rader utan innehåll utanför redigeraren och behålla dem i redigeraren så att fälten förblir redigerbara:
<?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; ?>
Borttagning av repeater
När en rad tas bort öppnas redigerarens bekräftelsedialog med knapparna Ta bort och Avbryt. Avbryt eller Escape lämnar raden oförändrad. Raden tas bort först efter bekräftelse, även i nästlade repeaters.
textRemove styr samma beteende för varje repeater:
| Värde | Beteende |
|---|---|
Utelämnat, true eller "" |
Visa standardfrågan för bekräftelse. |
| En icke-tom sträng | Visa den anpassade frågan med den befintliga mekanismen för översättning av anpassad text. |
false |
Ta bort raden direkt utan en dialog. |
Till exempel ändrar "textRemove": "Remove this team member?" frågan.
Den befintliga begränsningen min förhindrar fortfarande att rader under minimum tas bort.
Nästling av repeaters
En repeater-rad accepterar alla fälttyper utom tabs. Ett tabs-fält i en rad, även i en grupp utan id, visar ett meddelande i redigeraren i stället för sina fält. Tillägget PHPStan rapporterar det för block.json och field.json. Håll radens fält på samma nivå eller flytta flikarna utanför repeatern.
WYSIWYG-länkar
WYSIWYG-länkverktygsfältet infogar länkar som öppnas i samma flik utan att som standard lägga till target eller rel. Aktivera alternativet för ny flik med toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Om du väljer en ny flik läggs target="_blank" och rel="noreferrer noopener" till.
Om du stänger av det tas dessa automatiska attribut bort. Om du vill tillämpa attribut på varje länk i det fältet anger du toolbar.formats.link.attributes, till exempel { "class": "content-link", "rel": "nofollow" }. Explicit konfiguration bevaras, och säkerhetstoken för nya flikar läggs till i den konfigurerade rel.
Om du skriver en URL blir den inte automatiskt en länk, och om du klickar på en befintlig länk i fältet lämnar du inte redigeraren. Tidigare sparade länkattribut finns kvar i befintligt innehåll; de migreras inte automatiskt.