Ga naar de inhoud

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.

Kookboek met veldpatronen

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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

Hiermee wordt een linkbediening gerenderd om interne of externe links te kiezen.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "type": "tabs"
}

Eigenschappen

Eigenschap Type Beschrijving
tabs array De weer te geven tabbladen.

text

Hiermee wordt een invoerveld voor tekst op één regel gerenderd.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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
<?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.

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:

JSON
{
  "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.