Veldtypen
Blockstudio biedt verschillende veldtypen voor het bouwen van blokinterfaces.
Projecten kunnen ook hun eigen veldtypen met namespace registreren met
blockstudio/field_types. Gebruik dat
wanneer je een nieuw editorbedieningselement of een gestructureerde waarde nodig hebt. Gebruik
custom/{name}-velden wanneer je alleen
bestaande velden opnieuw wilt gebruiken.
Praktische recepten: voorwaardelijke groepen, slimme selectievakken, repeaters en doorzoekbare opslag.
Algemene eigenschappen
De onderstaande tabel bevat gedeelde eigenschappen en veelgebruikte waardeopties. default en fallback worden ondersteund waar ze in de tabel Eigenschappen van elk veldtype worden vermeld.
| Eigenschap | Type | Beschrijving |
|---|---|---|
id |
string | Unieke identificatie voor het attribuut |
type |
string | Het veldtype |
label |
string | Weergavelabel in de editor |
description |
string | Beschrijvingstekst onder het veld |
default |
mixed | Standaardwaarde voor het veld |
fallback |
mixed | Terugvalwaarde wanneer het veld leeg is |
help |
string | Helptekst die als tooltip naast het label wordt weergegeven |
hidden |
boolean | Verberg het veld in de UI |
switch |
boolean | Geef een schakelaar weer waarmee het veld kan worden uitgeschakeld. Standaard is false. |
translate |
boolean | Stel in op false om het veld weg te laten uit de configuratie van WPML |
conditions |
array | Regels voor voorwaardelijke logica |
Bestandsvelden met "returnFormat": "id" behouden geïmporteerde tekenreeksverwijzingen, waaronder enkele waarden in repeaters. Voor niet-opgeloste namen worden terugvalkaarten zonder miniaturen weergegeven; Blockstudio zet deze niet om in bijlage-ID’s. Zie verwijzingen naar draagbare media voor meer informatie.
Zie Pictogrammen laden voor picker-verzoeken, nieuwe pogingen en pictogramverzamelingen.
attributes
Geeft invoervelden voor data-attributen weer.
{
"type": "attributes"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
array |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
array |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
link |
boolean |
Hiermee wordt het selecteren van een link via een vervolgkeuzelijst ingeschakeld. |
media |
boolean |
Hiermee wordt het selecteren van media via een vervolgkeuzelijst ingeschakeld. |
block
Verwijst naar een ander Blockstudio-blok en vouwt de velden inline uit. In templates retourneert de waarde de gerenderde blokuitvoer.
{
"type": "block"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
block |
string |
De naam van het blok waarnaar wordt verwezen (e.g., "mytheme/card"). |
returnFormat |
string |
Hoe de waarde in templates moet worden geretourneerd. |
checkbox
Hiermee wordt een set selectievakjes gerenderd.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
array | string | number |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
array | string | number |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
options |
array |
Opties waaruit u kunt kiezen. |
returnFormat |
string |
Bepaalt de waarde van de retourindeling. |
populate |
object |
|
toggle |
boolean | string |
Voegt boven de opties een selectievakje toe waarmee u ze allemaal kunt selecteren of wissen. Een tekenreeks wordt gebruikt als label; true gebruikt het standaardlabel. |
classes
Hiermee wordt een veld gerenderd om CSS-klassen te selecteren.
{
"type": "classes"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
tailwind |
boolean |
Of Tailwind-klassen voor dit invoerveld moeten worden ingeschakeld. |
code
Hiermee wordt een code-editor gerenderd.
{
"type": "code"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
autoCompletion |
boolean |
Of automatisch aanvullen moet worden ingeschakeld. |
foldGutter |
boolean |
Of de vouwmarge moet worden weergegeven. |
height |
string |
De hoogte van de editor. |
language |
string |
De te gebruiken taal voor syntaxiskleuring. |
lineNumbers |
boolean |
Of regelnummers moeten worden weergegeven. |
maxHeight |
string |
De maximale hoogte van de editor. |
minHeight |
string |
De minimale hoogte van de editor. |
popout |
boolean |
Of een knop moet worden weergegeven waarmee de editor in een pop-upvenster wordt geopend. |
asset |
boolean |
Rendert CSS, SCSS of JavaScript uit het veld als een blokasset, zodat de template de stijl- of scripttag niet hoeft af te drukken. |
color
Hiermee wordt een kleurenpalet en kleurkiezer gerenderd.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Waarde van de optie die moet worden geselecteerd wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Waarde van de optie die wordt weergegeven wanneer de veldwaarde leeg is. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Of het palet een knop moet hebben om de selectie te wissen. |
disableCustomColors |
boolean |
Of aangepaste kleuren zijn toegestaan. |
date
Hiermee wordt een datumkiezer gerenderd.
{
"type": "date"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
startOfWeek |
number |
De dag waarop de week moet beginnen. 0 voor zondag, 1 voor maandag, enzovoort. |
datetime
Hiermee wordt een datum- en tijdkiezer gerenderd.
{
"type": "datetime"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
is12Hour |
boolean |
Of een 12-uursklok wordt gebruikt. Bij een 12-uursklok wordt een AM/PM-widget weergegeven en wordt de tijdnotatie verondersteld MM-DD-YYYY te zijn (in plaats van de standaardnotatie DD-MM-YYYY). |
files
Hiermee wordt een knop naar de mediabibliotheek gerenderd. Geselecteerde items kunnen inline opnieuw worden gerangschikt.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
array | object | number |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
array | object | number |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
addToGallery |
boolean |
Als dit waar is, wordt het galerijvenster voor media direct geopend in de mediabibliotheek, waar de gebruiker extra afbeeldingen kan toevoegen. Als dit onwaar is, wordt het galerijvenster voor media geopend in de bewerkingsmodus, waar de gebruiker bestaande afbeeldingen kan bewerken door ze opnieuw te rangschikken, te verwijderen of hun kenmerken te wijzigen. Alleen van toepassing als gallery === true. |
allowedTypes |
array | string |
Array met de typen media die vanuit de mediabibliotheek kunnen worden geüpload of geselecteerd. Elk type is een tekenreeks die het algemene MIME-type e.g kan bevatten: ‘image’, ‘audio’, ‘text’, of het volledige MIME-type e.g: ‘audio/mpeg’, ‘image/gif’. Als allowedTypes niet is ingesteld, moeten alle MIME-typen zijn toegestaan. |
gallery |
boolean |
Als dit waar is, initialiseert de component alle statussen die nodig zijn om een galerij weer te geven. Standaard wordt het mediavenster geopend in de galerijbewerkingsweergave, maar dit kan worden gewijzigd met de addToGalleryflag. |
max |
number |
Maximumaantal bestanden dat kan worden toegevoegd. |
min |
number |
Minimumaantal bestanden dat kan worden toegevoegd. |
multiple |
boolean |
Of meerdere selecties zijn toegestaan. |
size |
boolean |
Voegt een vervolgkeuzelijst voor mediaformaten aan het veld toe. |
textMediaButton |
string |
Tekst op de mediaknop. |
title |
string |
Titel die in het mediavenster wordt weergegeven. |
returnFormat |
string |
Geeft de indeling van de geretourneerde waarde op. |
returnSize |
string |
Het mediaformaat dat wordt geretourneerd bij gebruik van de retourindeling URL. |
gradient
Hiermee wordt een verlooppalet en verloopkiezer gerenderd.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Waarde van de optie die moet worden geselecteerd wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Waarde van de optie die wordt weergegeven wanneer de veldwaarde leeg is. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Of het palet een knop moet hebben om de selectie te wissen. |
disableCustomGradients |
boolean |
Of aangepaste kleuren zijn toegestaan. |
group
Hiermee worden meerdere velden in een (optioneel) inklapbare container gerenderd.
{
"type": "group"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
title |
string |
Titeltekst. Deze blijft zichtbaar wanneer de component is gesloten. |
opened |
boolean |
Indien ingesteld op true, blijft de component geopend, ongeacht de prop initialOpen en de |
initialOpen |
boolean |
Of het paneel aanvankelijk geopend is. |
scrollAfterOpen |
boolean |
Scrolt de inhoud in beeld wanneer deze zichtbaar is. |
class |
string |
Aangepaste CSS-klasse die op de groep wordt toegepast. |
style |
object |
Aangepaste CSS-stijlen die op de groep worden toegepast. |
attributes |
array |
Accepteert alle andere veldtypen behalve een andere tabs. |
html-tag
Hiermee wordt een HTML-tagkiezer gerenderd. Handig om kopniveaus of semantische elementen te kiezen.
{
"type": "html-tag"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
tags |
string | array |
Welke tags moeten worden opgenomen. Gebruik een vooraf ingestelde tekenreeks of een array met tagnamen. |
exclude |
array |
Tags die uit de voorinstelling moeten worden uitgesloten. Alleen van toepassing wanneer een vooringestelde tekenreeks voor tags wordt gebruikt. |
icon
Hiermee wordt een SVG-pictogram uit een pictogrammenset gerenderd.
{
"type": "icon"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
object |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
object |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
sets |
array | string |
Welke pictogrammenset moet worden opgenomen. Laat leeg om alles op te nemen. |
subSets |
array | string |
Welke subpictogrammenset moet worden opgenomen. Laat leeg om alles op te nemen. |
returnFormat |
string |
De indeling waarin het pictogram wordt geretourneerd. |
link
Hiermee wordt een linkbediening gerenderd om interne of externe links te kiezen.
{
"type": "link"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
object |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
object |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
hasRichPreviews |
boolean |
Of uitgebreide voorbeelden moeten worden getoond bij het toevoegen van een URL. |
noDirectEntry |
boolean |
Of een zoekopdracht zoals URL rechtstreeks in een link mag worden omgezet. |
noURLSuggestion |
boolean |
Of een terugvalsuggestie moet worden toegevoegd die de zoekopdracht als een URL behandelt. |
opensInNewTab |
boolean |
Voegt een schakelaar toe aan het linkvenster. |
showSuggestions |
boolean |
Of suggesties moeten worden getoond terwijl de URL wordt getypt. |
textButton |
string |
Aangepaste tekst die in de linkknop moet worden weergegeven. |
withCreateSuggestion |
boolean |
Of zoekopdrachten naar links zonder overeenkomst een suggestie mogen maken om een nieuwe conceptpagina aan te maken. |
message
Hiermee wordt een bericht met aangepaste inhoud gerenderd.
{
"type": "message"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
value |
string |
Het weer te geven bericht. Blok- en attribuutgegevens zijn beschikbaar in de haakjessyntaxis, e.g.: {block.title} of {attributes.text} |
number
Hiermee wordt een numeriek invoerveld gerenderd.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
number |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
number |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
dragDirection |
string |
Bepaalt de sleepas voor het verhogen of verlagen van de waarde. |
dragThreshold |
number |
Als isDragEnabled waar is, bepaalt dit hoeveel px er moet worden gesleept voordat de waarde verandert. |
hideHTMLArrows |
boolean |
Als dit waar is, worden de standaardpijlen van het invoerveld HTML verborgen. |
isShiftStepEnabled |
boolean |
Als dit waar is, wordt de muissleepbeweging ingeschakeld om de numerieke waarde te verhogen of te verlagen. Houd SHIFT ingedrukt tijdens het slepen om de waarde met shiftStep te verhogen. |
max |
number |
De maximale lengte van de waarde. |
min |
number |
Minimale lengte van de waarde. |
required |
boolean |
Als dit waar is, wordt een geldig getal binnen het min/max-bereik van de bediening afgedwongen. Als dit onwaar is, is een lege tekenreeks een geldige waarde. |
shiftStep |
number |
Hoeveel de waarde wordt verhoogd wanneer de SHIFT-toets is ingedrukt. Deze shiftStep is een vermenigvuldigingsfactor voor de stapwaarde. Als de stapwaarde bijvoorbeeld 5 is en shiftStep 10, wordt de waarde bij elke sprong met 50 verhoogd of verlaagd. |
step |
number |
Hoeveel de waarde verandert bij verhogen of verlagen. Dit is ook van invloed op de validatie: de waarde moet een veelvoud van step zijn (verschoven met min, indien opgegeven) om geldig te zijn. De speciale tekenreekswaarde any schakelt de validatiebeperking uit en zorgt ervoor dat stappen de waarde met 1 verhogen of verlagen. |
radio
Hiermee wordt een set keuzerondjes gerenderd.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string | number |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string | number |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
options |
array |
Opties waaruit u kunt kiezen. |
returnFormat |
string |
Hiermee wordt de waarde voor de retourindeling ingesteld. |
populate |
object |
|
display |
string |
Stel in op buttonGroup om de opties als groep knoppen weer te geven in plaats van als keuzerondjes. |
allowNull |
boolean |
Hiermee kan de gebruiker de waarde wissen door nogmaals op het geselecteerde keuzerondje te klikken. |
range
Hiermee wordt een bereikveld gerenderd om een numerieke waarde tussen twee punten in te stellen.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
number |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
number |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
allowReset |
boolean |
Als deze eigenschap waar is, wordt een knop weergegeven om de schuifregelaar opnieuw in te stellen. |
initialPosition |
number |
De beginpositie van de schuifregelaar, gebruikt wanneer geen waarde is doorgegeven. initialPosition wordt begrensd door de opgegeven min- en max-propwaarden. |
isShiftStepEnabled |
boolean |
Als dit waar is, wordt de muissleepbeweging ingeschakeld om de numerieke waarde te verhogen of te verlagen. Houd SHIFT ingedrukt tijdens het slepen om de waarde met shiftStep te verhogen. |
marks |
array |
Geeft een visuele weergave van stapmarkeringen weer. Aangepaste markeringen kunnen als Array worden opgegeven. |
max |
number |
De maximale lengte van de waarde. |
min |
number |
Minimale lengte van de waarde. |
railColor |
string |
CSS-kleurtekenreeks om de achtergrond van het rail-element aan te passen. |
resetFallbackValue |
number |
De waarde waarnaar wordt teruggekeerd als op de knop Reset wordt geklikt (ingeschakeld door allowReset). |
separatorType |
string |
Bepaalt of de scheidingslijn onder of boven de bedieningsrij moet worden uitgeschakeld of de volledige breedte moet hebben. Standaard staat deze onderaan, zonder de bedieningsknop te onderstrepen. |
shiftStep |
number |
Hoeveel de waarde wordt verhoogd wanneer de SHIFT-toets is ingedrukt. Deze shiftStep is een vermenigvuldigingsfactor voor de stapwaarde. Als de stapwaarde bijvoorbeeld 5 is en shiftStep 10, wordt de waarde bij elke sprong met 50 verhoogd of verlaagd. |
showTooltip |
boolean |
Dwingt de Tooltip UI af te tonen of te verbergen. Dit wordt overschreven naar false wanneer step is ingesteld op de speciale tekenreekswaarde any. |
step |
number |
Hoeveel de waarde verandert bij verhogen of verlagen. Dit is ook van invloed op de validatie: de waarde moet een veelvoud van step zijn (verschoven met min, indien opgegeven) om geldig te zijn. De speciale tekenreekswaarde any schakelt de validatiebeperking uit en zorgt ervoor dat stappen de waarde met 1 verhogen of verlagen. |
trackColor |
string |
CSS-kleurtekenreeks om de achtergrond van het track-element aan te passen. |
withInputField |
boolean |
Bepaalt of het numerieke invoerveld naast de RangeControl wordt weergegeven. Dit wordt overschreven naar false wanneer step is ingesteld op de speciale tekenreekswaarde any. |
select
Hiermee wordt een selectievak gerenderd dat één of meerdere selecties ondersteunt.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
array | string | number |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
array | string | number |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
multiple |
boolean |
Als dit waar is, kunnen meerdere opties worden geselecteerd. "stylisedUi" wordt automatisch ingeschakeld. |
options |
array |
Opties om uit te kiezen. |
returnFormat |
string |
Geeft de indeling van de geretourneerde waarde op. |
populate |
object |
|
stylisedUi |
boolean |
Rendert een gestileerde versie van een selectievak waarin items kunnen worden doorzocht. |
allowNull |
boolean | string |
Hiermee kan de gebruiker een lege keuze selecteren. Als dit waar is, is het label leeg; anders wordt de opgegeven tekenreeks als optie weergegeven. |
allowReset |
boolean |
Als deze eigenschap waar is, wordt een knop weergegeven om de selectie opnieuw in te stellen. |
tabs
Hiermee wordt een interface met tabbladen gerenderd om velden te groeperen.
{
"type": "tabs"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
tabs |
array |
De weer te geven tabbladen. |
text
Hiermee wordt een invoerveld voor tekst op één regel gerenderd.
{
"type": "text",
"min": 0,
"max": 100
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
max |
number |
De maximale lengte van de waarde. |
min |
number |
Minimale lengte van de waarde. |
textarea
Hiermee wordt een textarea-invoerveld gerenderd.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
max |
number |
De maximale lengte van de waarde. |
min |
number |
Minimale lengte van de waarde. |
rows |
number |
Het aantal rijen dat de textarea moet bevatten. |
toggle
Hiermee wordt een waar/onwaar-schakelaar gerenderd.
{
"type": "toggle"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
boolean |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
boolean |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
repeater
Rendert een set velden die herhaald kunnen worden.
{
"type": "repeater",
"min": 0,
"max": 100
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
array |
Rijen waarmee een nieuw blok begint. Elke rij is een object met veldwaarden. Heeft voorrang op de rijen die door min worden aangemaakt. |
min |
number |
Minimumaantal rijen. |
max |
number |
Maximumaantal rijen. |
minimized |
boolean |
Klap de bestaande rijen in wanneer de editor wordt geopend. Rijen die in de editor worden toegevoegd, zijn uitgeklapt. |
textButton |
string |
Tekst voor de knop Toevoegen. |
textMinimized |
string | object |
Tekst die wordt weergegeven wanneer rijen zijn ingeklapt. |
textRemove |
string | boolean |
Bevestigingsvraag die in de editor wordt weergegeven wanneer een herhalerrij wordt verwijderd. Een niet-lege tekenreeks wijzigt de vraag; false verwijdert de rij direct, zonder dialoogvenster. Als deze optie is weggelaten, op true staat of een lege tekenreeks bevat, wordt de standaardvraag gebruikt. |
attributes |
array |
Accepteert alle andere veldtypen, behalve een ander tabblad. |
richtext
Attribuutveld voor RichText-velden.
{
"type": "richtext"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer het veld leeg is. |
unit
Rendert een getalinvoerveld met een eenhedenkeuzelijst.
{
"type": "unit"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer het veld leeg is. |
disableUnits |
boolean |
Als dit true is, wordt het veld voor het kiezen van eenheden verborgen. |
isPressEnterToChange |
boolean |
Als dit true is, moet de ENTER-toets worden ingedrukt om een onChange te activeren. Als dit is ingeschakeld, wordt er ook een wijziging geactiveerd wanneer u met Tab het veld verlaat. |
isResetValueOnUnitChange |
boolean |
Als dit true is en de geselecteerde eenheid een standaardwaarde heeft, wordt deze waarde ingesteld wanneer u van eenheid wisselt. |
isUnitSelectTabbable |
boolean |
Bepaalt of het veld voor het kiezen van eenheden met Tab bereikbaar is. |
units |
array |
wysiwyg
Rendert een WYSIWYG-editor.
{
"type": "wysiwyg"
}
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
default |
string |
Standaardwaarde die moet worden toegepast wanneer het blok voor het eerst wordt toegevoegd. |
fallback |
string |
Terugvalwaarde die wordt weergegeven wanneer de veldwaarde leeg is. |
toolbar |
object |
De werkbalkconfiguratie voor de editor. |
mode |
string |
code opent het veld in de codeweergave. both voegt een knop toe om te schakelen tussen de visuele weergave en de codeweergave. |
Pictogrammen laden
De editor laadt een pictogramset wanneer u de kiezer voor het eerst activeert of de set of subset wijzigt, niet wanneer u het blok selecteert. Velden die dezelfde set aanvragen, delen een lopend verzoek. De opgeslagen pictogramnaam blijft zichtbaar voordat de set is geladen; als een verzoek mislukt, kunt u het opnieuw proberen door de kiezer opnieuw te activeren.
tabler-icons ondersteunt outline en filled. Een subset die expliciet is geconfigureerd
voor de gekozen set, heeft voorrang; anders gebruikt de kiezer solid als die
beschikbaar is, of de eerste subset van de set. Sets zonder subsets laten subSet weg.
Setnamen verwijzen alleen naar meegeleverde bestanden. Bij frontend-rendering worden afzonderlijke
pictogrammen gecachet in plaats van volledige pictogramsets op te slaan in tijdelijke databasegegevens.
Geïmporteerde optiewaarden
Selectievakjes en keuzelijsten met "multiple": true slaan normaal gesproken een array met
{ "value": "...", "label": "..." }-objecten op. Ze accepteren ook één optieobject, een scalaire tekenreeks of een getal, of een array met scalaire waarden die zijn geïmporteerd via de REST API of inhoudstools. Dit werkt ook binnen herhalerrijen.
De editor toont deze waarden als selecties zonder hun opgeslagen vorm te wijzigen wanneer u opslaat zonder wijzigingen. Als u een selectie toevoegt of verwijdert, wordt de gebruikelijke array met optieobjecten opgeslagen. Numerieke 0 en tekenreekswaarden "0" zijn geldige selecties.
Templates ontvangen de geconfigureerde returnFormat van het veld, net als bij waarden die in de editor zijn geselecteerd. Opties moeten nog steeds overeenkomen met de gedeclareerde of ingevulde keuzes van het veld.
Een native keuzelijst voor één optie zonder opgeslagen waarde of standaardwaarde toont een uitgeschakelde, lege tijdelijke aanduiding in plaats van de eerste optie. Als u de eerste optie kiest, wordt deze expliciet opgeslagen. Zodra een keuze is opgeslagen, verdwijnt de tijdelijke aanduiding. Gebruik allowNull wanneer redacteuren ook een selectie moeten kunnen wissen; een lege tijdelijke aanduiding maakt een anderszins verplichte keuze niet wisbaar.
Initiële herhalerrijen
In de editor bevatten standaardwaarden geneste minimumrijen voordat ze worden ingevoegd. U hoeft de blokinstellingen niet te openen om deze te initialiseren, en het invoegen van het blok voegt voor die rijen geen tweede stap aan de ongedaanmakingsgeschiedenis toe.
Wanneer een repeater min heeft, maar geen opgeslagen waarde of expliciete default, initialiseert de server zoveel rijen met de standaardwaarden van de rijvelden. Dit geldt ook voor PHP-insluitingen, blocktags en paginabronnen op basis van bestanden die nooit in de editor zijn geopend. Bijvoorbeeld: "min": 2 met een tekstveld waarvan de standaardwaarde "New item" is, geeft twee rijen met die waarde weer.
Opgeslagen rijen en een expliciete repeater-default hebben voorrang. Een expliciet opgeslagen lege lijst, false of null maakt verwijderde rijen niet opnieuw aan. Tijdens het weergeven worden deze gegenereerde standaardwaarden niet naar het bericht teruggeschreven. min en max beperken de bedieningselementen in de editor; ze korten een opgeslagen lijst niet in en vullen die tijdens het weergeven niet aan. Gebruik bs_validate_block() om overtredingen van rijlimieten in geïmporteerde inhoud te melden.
Rijvelden zonder default zijn false in een gegenereerde rij, waardoor zo’n rij geen inhoud heeft. Rijen die editors toevoegen en leeg laten, zien er hetzelfde uit. Een template die voor elke rij een kaart, kop of lijstitem weergeeft, moet rijen zonder inhoud buiten de editor overslaan en ze in de editor behouden, zodat hun velden bewerkbaar blijven:
<?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; ?>
Een repeater verwijderen
Als u een rij verwijdert, opent de editor een bevestigingsvenster met de knoppen Verwijderen en Annuleren. Annuleren of Escape laat de rij ongewijzigd. De rij wordt pas na bevestiging verwijderd, ook binnen geneste repeaters.
textRemove bepaalt dit gedrag voor elke repeater:
| Waarde | Gedrag |
|---|---|
Weggelaten, true of "" |
Toon de standaardbevestigingsvraag. |
| Een niet-lege tekenreeks | Toon die aangepaste vraag met het bestaande vertaalmechanisme voor aangepaste tekst. |
false |
Verwijder de rij direct, zonder dialoogvenster. |
Met bijvoorbeeld "textRemove": "Remove this team member?" wijzigt u de vraag.
De bestaande beperking min voorkomt nog steeds dat rijen onder het minimum worden verwijderd.
Repeaters nesten
Een repeaterrij accepteert elk veldtype behalve tabs. Een veld van het type tabs in een rij, ook binnen een groep zonder id, toont in de editor een melding in plaats van de velden. De extensie PHPStanuitbreiding meldt dit voor block.json en field.json. Houd de velden van de rij plat of verplaats de tabbladen buiten de repeater.
WYSIWYG-koppelingen
De WYSIWYG-koppelingswerkbalk voegt standaard koppelingen naar hetzelfde tabblad in, zonder target of rel toe te voegen. Schakel de optie voor een nieuw tabblad in met toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Als u een nieuw tabblad kiest, worden target="_blank" en rel="noreferrer noopener" toegevoegd.
Als u deze optie uitschakelt, worden die automatische attributen verwijderd. Stel toolbar.formats.link.attributes in om attributen op elke koppeling in dat veld toe te passen, bijvoorbeeld { "class": "content-link", "rel": "nofollow" }. Expliciete configuratie blijft behouden en veiligheidstokens voor nieuwe tabbladen worden toegevoegd aan de geconfigureerde rel.
Een URL typen maakt er niet automatisch een koppeling van, en als u in het veld op een bestaande koppeling klikt, verlaat u de editor niet. Eerder opgeslagen koppelingsattributen blijven behouden in bestaande inhoud; ze worden niet automatisch gemigreerd.