Feldtypen
Blockstudio bietet verschiedene Feldtypen zum Erstellen von Blockoberflächen.
Projekte können auch eigene Feldtypen mit Namespace über blockstudio/field_types registrieren. Verwende diese, wenn du ein neues Editor-Steuerelement oder eine strukturierte Wertform benötigst. Verwende custom/{name}-Felder, wenn du lediglich eine Gruppe vorhandener Felder wiederverwenden möchtest.
Praktische Beispiele: bedingte Gruppen, intelligente Auswahlfelder, Repeater und abfragbarer Speicher.
Allgemeine Eigenschaften
Die folgende Tabelle enthält gemeinsame Eigenschaften und gängige Wertoptionen. default und fallback werden unterstützt, sofern sie in der Tabelle „Properties“ des jeweiligen Feldtyps aufgeführt sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
id |
string | Eindeutiger Bezeichner für das Attribut |
type |
string | Der Feldtyp |
label |
string | Anzeigebezeichnung im Editor |
description |
string | Beschreibungstext unter dem Feld |
default |
mixed | Standardwert für das Feld |
fallback |
mixed | Ersatzwert, wenn das Feld leer ist |
help |
string | Hilfetext als Tooltip neben der Bezeichnung |
hidden |
boolean | Feld im UI ausblenden |
switch |
boolean | Einen Umschalter anzeigen, mit dem sich das Feld deaktivieren lässt. Standardmäßig false. |
translate |
boolean | Auf false setzen, um das Feld aus der Konfiguration WPML auszuschließen |
conditions |
array | Regeln für bedingte Logik |
Dateifelder mit "returnFormat": "id" behalten importierte Zeichenfolgenreferenzen bei, auch einzelne Werte innerhalb von Repeatern. Nicht aufgelöste Namen zeigen Ersatzkarten ohne Miniaturansichten; Blockstudio löst sie nicht in Anhang-IDs auf. Weitere Informationen findest du unter portable Medienreferenzen.
Weitere Informationen zu Icon Loading: Anfragen des Auswahlfelds, erneute Versuche und Icon-Teilmengen.
attributes
Rendert Eingabefelder für Datenattribute.
{
"type": "attributes"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
array |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
array |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
link |
boolean |
Ermöglicht die Linkauswahl über ein Dropdown-Menü. |
media |
boolean |
Ermöglicht die Medienauswahl über ein Dropdown-Menü. |
Block
Referenziert einen anderen Blockstudio-Block und zeigt dessen Felder inline an. In Vorlagen gibt der Wert die gerenderte Blockausgabe zurück.
{
"type": "block"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
block |
string |
Name des zu referenzierenden Blocks (e.g., "mytheme/card"). |
returnFormat |
string |
Legt fest, wie der Wert in Vorlagen zurückgegeben wird. |
Kontrollkästchen
Zeigt mehrere Kontrollkästchen an.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
array | string | number |
Standardwert, der beim erstmaligen Hinzufügen des Blocks angewendet werden soll. |
fallback |
array | string | number |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
options |
array |
Auswahlmöglichkeiten. |
returnFormat |
string |
Legt das Rückgabeformat fest. |
populate |
object |
|
toggle |
boolean | string |
Fügt über den Optionen ein Kontrollkästchen hinzu, mit dem du alle auswählst oder abwählst. Eine Zeichenfolge dient als Beschriftung; bei true wird die Standardbeschriftung verwendet. |
Klassen
Zeigt ein Feld zur Auswahl von CSS-Klassen an.
{
"type": "classes"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
tailwind |
boolean |
Legt fest, ob Tailwind-Klassen für dieses Eingabefeld aktiviert werden. |
Code
Zeigt einen Code-Editor an.
{
"type": "code"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim erstmaligen Hinzufügen des Blocks angewendet wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
autoCompletion |
boolean |
Gibt an, ob die automatische Vervollständigung aktiviert werden soll. |
foldGutter |
boolean |
Gibt an, ob der Ein-/Ausklappbereich angezeigt werden soll. |
height |
string |
Die Höhe des Editors. |
language |
string |
Die Sprache für die Syntaxhervorhebung. |
lineNumbers |
boolean |
Gibt an, ob Zeilennummern angezeigt werden sollen. |
maxHeight |
string |
Die maximale Höhe des Editors. |
minHeight |
string |
Die minimale Höhe des Editors. |
popout |
boolean |
Gibt an, ob eine Schaltfläche angezeigt werden soll, die den Editor in einem Pop-up-Fenster öffnet. |
asset |
boolean |
Rendert CSS, SCSS oder JavaScript aus dem Feld als Block-Asset, sodass die Vorlage das Style- oder Script-Tag nicht ausgeben muss. |
Farbe
Zeigt eine Farbpalette und einen Farbwähler an.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Wert der Option, die beim erstmaligen Hinzufügen des Blocks ausgewählt sein soll. |
fallback |
string |
Wert der Option, die angezeigt wird, wenn das Feld leer ist. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Gibt an, ob die Palette eine Schaltfläche zum Löschen haben soll. |
disableCustomColors |
boolean |
Gibt an, ob benutzerdefinierte Farben erlaubt sein sollen. |
Datum
Zeigt einen Datumsauswähler an.
{
"type": "date"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
startOfWeek |
number |
Wochentag, an dem die Woche beginnen soll. 0 steht für Sonntag, 1 für Montag usw. |
Datum und Uhrzeit
Zeigt einen Datum- und Uhrzeitauswähler an.
{
"type": "datetime"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
is12Hour |
boolean |
Legt fest, ob eine 12-Stunden-Uhr verwendet wird. Dabei wird ein AM/PM-Steuerelement angezeigt und das Zeitformat als MM-DD-YYYY angenommen (anstelle des Standardformats DD-MM-YYYY). |
Dateien
Zeigt eine Schaltfläche zur Mediathek an. Ausgewählte Elemente können direkt neu angeordnet werden.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
array | object | number |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
array | object | number |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
addToGallery |
boolean |
Wenn true, öffnet sich das Medien-Modal der Galerie direkt in der Mediathek, wo zusätzliche Bilder hinzugefügt werden können. Wenn false, öffnet es sich im Bearbeitungsmodus. Dort können vorhandene Bilder neu angeordnet, entfernt oder ihre Attribute geändert werden. Gilt nur, wenn gallery === true. |
allowedTypes |
array | string |
Array mit den Medientypen, die aus der Mediathek hochgeladen oder ausgewählt werden können. Jeder Typ ist ein String, der den allgemeinen MIME-Typ e.g enthalten kann: ‘image’, ‘audio’, ‘text’, oder den vollständigen MIME-Typ e.g: ‘audio/mpeg’, ‘image/gif’. Wenn allowedTypes nicht festgelegt ist, sind alle MIME-Typen zulässig. |
gallery |
boolean |
Wenn true, initialisiert die Komponente alle Zustände, die für eine Galerie erforderlich sind. Standardmäßig öffnet sich das Medien-Modal im Galerie-Bearbeitungsmodus. Dies lässt sich mit dem Flag addToGallery ändern. |
max |
number |
Maximale Anzahl hinzufügbarer Dateien. |
min |
number |
Minimale Anzahl hinzufügbarer Dateien. |
multiple |
boolean |
Legt fest, ob mehrere Elemente ausgewählt werden können. |
size |
boolean |
Fügt dem Feld ein Dropdown-Menü für die Mediengröße hinzu. |
textMediaButton |
string |
Text der Medientaste. |
title |
string |
Titel im Medien-Modal. |
returnFormat |
string |
Legt das Rückgabeformat fest. |
returnSize |
string |
Mediengröße, die bei Verwendung des Rückgabeformats URL zurückgegeben wird. |
Verlauf
Zeigt eine Verlaufspalette und einen Verlaufswähler an.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Wert der Option, die beim erstmaligen Hinzufügen des Blocks ausgewählt sein soll. |
fallback |
string |
Wert der Option, die angezeigt wird, wenn das Feld leer ist. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Gibt an, ob die Palette eine Schaltfläche zum Löschen haben soll. |
disableCustomGradients |
boolean |
Gibt an, ob benutzerdefinierte Farben erlaubt sein sollen. |
Gruppe
Zeigt mehrere Felder in einem (optional) einklappbaren Container an.
{
"type": "group"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
title |
string |
Titeltext. Er wird auch angezeigt, wenn die Komponente geschlossen ist. |
opened |
boolean |
Wenn true, bleibt die Komponente unabhängig von der Eigenschaft initialOpen und dem |
initialOpen |
boolean |
Legt fest, ob das Panel anfangs geöffnet ist. |
scrollAfterOpen |
boolean |
Scrollt den Inhalt in den sichtbaren Bereich, sobald er sichtbar ist. |
class |
string |
Benutzerdefinierte CSS-Klasse, die auf die Gruppe angewendet wird. |
style |
object |
Benutzerdefinierte CSS-Stile, die auf die Gruppe angewendet werden. |
attributes |
array |
Akzeptiert alle anderen Feldtypen außer einem weiteren Tabset. |
HTML-Tag
Zeigt einen HTML-Tag-Auswähler an. Nützlich zur Auswahl von Überschriftenebenen oder semantischen Elementen.
{
"type": "html-tag"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
tags |
string | array |
Gibt an, welche Tags enthalten sein sollen. Verwende eine vordefinierte Zeichenfolge oder ein Array mit Tagnamen. |
exclude |
array |
Tags, die von der Voreinstellung ausgeschlossen werden sollen. Gilt nur, wenn für tags eine vordefinierte Zeichenfolge verwendet wird. |
Symbol
Zeigt ein SVG-Symbol aus einer Symbolsammlung an.
{
"type": "icon"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
object |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
object |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
sets |
array | string |
Gibt an, welche Symbolsammlung enthalten sein soll. Leer lassen, um alle einzubeziehen. |
subSets |
array | string |
Gibt an, welche Untersammlung von Symbolen enthalten sein soll. Leer lassen, um alle einzubeziehen. |
returnFormat |
string |
Format, in dem das Symbol zurückgegeben wird. |
Link
Zeigt ein Link-Steuerelement zur Auswahl interner oder externer Links an.
{
"type": "link"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
object |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
object |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
hasRichPreviews |
boolean |
Legt fest, ob beim Hinzufügen eines URL Rich-Vorschauen angezeigt werden. |
noDirectEntry |
boolean |
Legt fest, ob eine Suchanfrage im Stil von URL direkt in einen Link umgewandelt werden kann. |
noURLSuggestion |
boolean |
Legt fest, ob ein Ersatzvorschlag hinzugefügt wird, der die Suchanfrage als URL behandelt. |
opensInNewTab |
boolean |
Fügt dem Link-Modal einen Umschalter hinzu. |
showSuggestions |
boolean |
Legt fest, ob während der Eingabe des URL Vorschläge angezeigt werden. |
textButton |
string |
Benutzerdefinierter Text für die Link-Schaltfläche. |
withCreateSuggestion |
boolean |
Legt fest, ob Suchanfragen ohne passenden Link einen Vorschlag zum Erstellen einer neuen Entwurfsseite anzeigen können. |
Nachricht
Zeigt eine Nachricht mit benutzerdefiniertem Inhalt an.
{
"type": "message"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
value |
string |
Anzuzeigende Nachricht. Block- und Attributdaten sind in eckiger Klammernsyntax verfügbar, e.g.: {block.title} oder {attributes.text} |
Zahl
Zeigt ein Zahleneingabefeld an.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
number |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
number |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
dragDirection |
string |
Legt die Ziehachse zum Erhöhen oder Verringern des Werts fest. |
dragThreshold |
number |
Wenn isDragEnabled true ist, gibt dies an, wie viele px gezogen werden muss, bevor sich der Wert ändert. |
hideHTMLArrows |
boolean |
Wenn true, werden die standardmäßigen Pfeile des Eingabefelds HTML ausgeblendet. |
isShiftStepEnabled |
boolean |
Wenn true, aktiviert dies die Mausziehgeste zum Erhöhen oder Verringern des Zahlenwerts. Wenn du beim Ziehen die UMSCHALT-Taste gedrückt hältst, wird der Wert um shiftStep erhöht. |
max |
number |
Maximale Länge des Werts. |
min |
number |
Minimale Länge des Werts. |
required |
boolean |
Wenn true, wird eine gültige Zahl innerhalb des min/max-Bereichs des Steuerelements erzwungen. Wenn false, ist auch eine leere Zeichenfolge ein gültiger Wert. |
shiftStep |
number |
Erhöhungsschritt bei gedrückter UMSCHALT-Taste. Dieser Wert multipliziert den Schrittwert. Ist der Schrittwert beispielsweise 5 und shiftStep 10, wird der Wert bei jedem Sprung um 50 erhöht oder verringert. |
step |
number |
Betrag, um den sich der Wert beim Erhöhen oder Verringern ändert. Der Wert wird auch bei der Validierung berücksichtigt: Er muss ein Vielfaches von step (mit einem Versatz um min, falls angegeben) sein. Der spezielle Stringwert any hebt die Validierungsbedingung auf und bewirkt, dass Schritte den Wert jeweils um 1 erhöhen oder verringern. |
Optionsfeld
Zeigt mehrere Optionsfelder an.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string | number |
Standardwert, der beim erstmaligen Hinzufügen des Blocks angewendet wird. |
fallback |
string | number |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
options |
array |
Verfügbare Optionen. |
returnFormat |
string |
Gibt das Rückgabeformat an. |
populate |
object |
|
display |
string |
Auf buttonGroup setzen, um die Optionen als Gruppe von Schaltflächen statt als Optionsfelder anzuzeigen. |
allowNull |
boolean |
Ermöglicht es dem Benutzer, den Wert zu löschen, indem er das ausgewählte Optionsfeld erneut anklickt. |
Bereich
Zeigt einen Bereichsregler an, mit dem sich ein Zahlenwert zwischen zwei Punkten festlegen lässt.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
number |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
number |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
allowReset |
boolean |
Wenn diese Eigenschaft true ist, wird eine Schaltfläche zum Zurücksetzen des Reglers angezeigt. |
initialPosition |
number |
Startposition des Reglers, wenn kein Wert übergeben wird. initialPosition wird auf die angegebenen min- und max-Prop-Werte begrenzt. |
isShiftStepEnabled |
boolean |
Wenn true, aktiviert dies die Mausziehgeste zum Erhöhen oder Verringern des Zahlenwerts. Wenn du beim Ziehen die UMSCHALT-Taste gedrückt hältst, wird der Wert um shiftStep erhöht. |
marks |
array |
Zeigt die Schrittmarkierungen visuell an. Benutzerdefinierte Markierungen können als Array angegeben werden. |
max |
number |
Maximale Länge des Werts. |
min |
number |
Minimale Länge des Werts. |
railColor |
string |
CSS-Farbstring zum Anpassen des Hintergrunds der Schienenelemente. |
resetFallbackValue |
number |
Wert, auf den zurückgesetzt wird, wenn die Schaltfläche zum Zurücksetzen angeklickt wird (aktiviert durch allowReset). |
separatorType |
string |
Legt fest, ob die Trennlinie über oder unter der Steuerzeile deaktiviert werden soll oder die volle Breite einnimmt. Standardmäßig befindet sie sich darunter und reicht bis auf das Symbol für die Steuerung. |
shiftStep |
number |
Erhöhungsschritt bei gedrückter UMSCHALT-Taste. Dieser Wert multipliziert den Schrittwert. Ist der Schrittwert beispielsweise 5 und shiftStep 10, wird der Wert bei jedem Sprung um 50 erhöht oder verringert. |
showTooltip |
boolean |
Erzwingt das Ein- oder Ausblenden des Tooltips UI. Wird überschrieben und auf false gesetzt, wenn step auf den speziellen Stringwert any gesetzt ist. |
step |
number |
Betrag, um den sich der Wert beim Erhöhen oder Verringern ändert. Der Wert wird auch bei der Validierung berücksichtigt: Er muss ein Vielfaches von step (mit einem Versatz um min, falls angegeben) sein. Der spezielle Stringwert any hebt die Validierungsbedingung auf und bewirkt, dass Schritte den Wert jeweils um 1 erhöhen oder verringern. |
trackColor |
string |
CSS-Farbstring zum Anpassen des Hintergrunds der Spur. |
withInputField |
boolean |
Legt fest, ob neben dem RangeControl ein Zahlenfeld angezeigt wird. Wird überschrieben und auf false gesetzt, wenn step auf den speziellen Stringwert any gesetzt ist. |
Auswahlliste
Zeigt ein Auswahlfeld an, das eine oder mehrere Auswahlen unterstützt.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
array | string | number |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
array | string | number |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
multiple |
boolean |
Wenn true, können mehrere Optionen ausgewählt werden. "stylisedUi" wird automatisch aktiviert. |
options |
array |
Verfügbare Optionen. |
returnFormat |
string |
Legt das Rückgabeformat fest. |
populate |
object |
|
stylisedUi |
boolean |
Zeigt eine gestaltete Version des Auswahlfelds an, in der sich die Einträge durchsuchen lassen. |
allowNull |
boolean | string |
Ermöglicht die Auswahl einer leeren Option. Bei true ist die Beschriftung leer, andernfalls zeigt die Option die angegebene Zeichenfolge an. |
allowReset |
boolean |
Wenn diese Eigenschaft true ist, wird eine Schaltfläche zum Zurücksetzen der Auswahl angezeigt. |
Tabs
Zeigt eine Oberfläche mit Tabs zum Gruppieren von Feldern an.
{
"type": "tabs"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
tabs |
array |
Anzuzeigende Tabs. |
Text
Zeigt ein einzeiliges Texteingabefeld an.
{
"type": "text",
"min": 0,
"max": 100
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
max |
number |
Maximale Länge des Werts. |
min |
number |
Minimale Länge des Werts. |
Textbereich
Zeigt ein Textbereich-Eingabefeld an.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
max |
number |
Maximale Länge des Werts. |
min |
number |
Minimale Länge des Werts. |
rows |
number |
Anzahl der Zeilen im Textbereich. |
Umschalter
Zeigt einen Ein/Aus-Umschalter an.
{
"type": "toggle"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
boolean |
Standardwert, der beim ersten Hinzufügen des Blocks festgelegt wird. |
fallback |
boolean |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
Wiederholer
Rendert eine Reihe von Feldern, die wiederholt werden können.
{
"type": "repeater",
"min": 0,
"max": 100
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
array |
Zeilen, mit denen ein neuer Block beginnt. Jede Zeile ist ein Objekt mit Feldwerten. Hat Vorrang vor den Zeilen, die min erstellt. |
min |
number |
Mindestanzahl der Zeilen. |
max |
number |
Höchstanzahl der Zeilen. |
minimized |
boolean |
Klappt vorhandene Zeilen ein, wenn der Editor geöffnet wird. Im Editor hinzugefügte Zeilen sind zunächst ausgeklappt. |
textButton |
string |
Text der Schaltfläche zum Hinzufügen. |
textMinimized |
string | object |
Text, der angezeigt wird, wenn Zeilen minimiert sind. |
textRemove |
string | boolean |
Bestätigungsfrage, die beim Entfernen einer Repeater-Zeile im Editor angezeigt wird. Eine nicht leere Zeichenfolge ändert die Frage; false entfernt die Zeile sofort ohne Dialog. Wird der Wert weggelassen, auf true gesetzt oder als leere Zeichenfolge angegeben, wird die Standardfrage verwendet. |
attributes |
array |
Akzeptiert alle anderen Feldtypen außer einem weiteren Tabs-Feld. |
Richtext
Attributfeld für RichText-Felder.
{
"type": "richtext"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim erstmaligen Hinzufügen des Blocks übernommen wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
Einheit
Rendert ein Zahleneingabefeld mit einer Einheitenauswahl.
{
"type": "unit"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim erstmaligen Hinzufügen des Blocks übernommen wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
disableUnits |
boolean |
Wenn true, wird das Einheitenauswahlfeld ausgeblendet. |
isPressEnterToChange |
boolean |
Wenn true, muss die ENTER-Taste gedrückt werden, um ein onChange auszulösen. Ist diese Option aktiviert, wird eine Änderung auch beim Wegtabben ausgelöst. |
isResetValueOnUnitChange |
boolean |
Wenn true und für die ausgewählte Einheit ein Standardwert festgelegt ist, wird dieser Wert beim Wechsel der Einheit übernommen. |
isUnitSelectTabbable |
boolean |
Legt fest, ob das Einheitenauswahlfeld per Tabulator erreichbar ist. |
units |
array |
WYSIWYG
Rendert einen WYSIWYG-Editor.
{
"type": "wysiwyg"
}
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
default |
string |
Standardwert, der beim erstmaligen Hinzufügen des Blocks angewendet wird. |
fallback |
string |
Ersatzwert, der angezeigt wird, wenn das Feld leer ist. |
toolbar |
object |
Symbolleistenkonfiguration für den Editor. |
mode |
string |
code öffnet das Feld in der Codeansicht. both fügt eine Schaltfläche hinzu, mit der zwischen visueller Ansicht und Codeansicht gewechselt werden kann. |
Symbole laden
Der Editor lädt einen Symbolsatz, wenn du den Auswahlbereich erstmals fokussierst oder den Satz beziehungsweise die Untergruppe änderst, nicht wenn du den Block auswählst. Felder, die denselben Satz anfordern, teilen sich die laufende Anfrage. Der gespeicherte Symbolname bleibt vor dem Laden sichtbar, und wenn eine Anfrage fehlschlägt, wird sie beim erneuten Fokussieren des Auswahlbereichs wiederholt.
tabler-icons unterstützt outline und filled. Eine ausdrücklich für den ausgewählten Satz konfigurierte Untergruppe hat Vorrang; andernfalls verwendet die Auswahl solid, sofern verfügbar, oder die erste Untergruppe des Satzes. Sätze ohne Untergruppen lassen subSet weg. Satznamen werden nur Dateien aus dem Paket zugeordnet. Beim Rendern im Frontend werden einzelne Symbole zwischengespeichert, statt vollständige Symbolgruppen in temporären Datenbankeinträgen zu speichern.
Importierte Optionswerte
Checkboxen und Auswahlfelder mit "multiple": true speichern normalerweise ein Array aus { "value": "...", "label": "..." }-Objekten. Sie akzeptieren außerdem ein einzelnes Optionsobjekt, eine skalare Zeichenfolge oder Zahl sowie ein Array skalarer Werte, die über die Tools REST API oder für Inhalte importiert wurden. Das funktioniert auch innerhalb von Repeater-Zeilen.
Der Editor zeigt diese Werte als Auswahl an, ohne ihre gespeicherte Struktur beim Speichern unveränderter Daten umzuschreiben. Wird eine Auswahl hinzugefügt oder entfernt, wird das übliche Array aus Optionsobjekten gespeichert. Numerische 0 und Zeichenfolgen-"0" sind gültige Auswahlwerte. Vorlagen erhalten den konfigurierten returnFormat des Felds, genauso wie bei im Editor ausgewählten Werten. Die Optionen müssen weiterhin den deklarierten oder befüllten Auswahlmöglichkeiten des Felds entsprechen.
Ein natives Einzelauswahlfeld zeigt ohne gespeicherten Wert oder Standardwert einen deaktivierten leeren Platzhalter an, nicht seine erste Option. Wenn du die erste Option auswählst, wird sie ausdrücklich gespeichert. Sobald eine Auswahl gespeichert ist, verschwindet der Platzhalter. Verwende allowNull, wenn Bearbeiter eine Auswahl auch löschen können sollen. Ein leerer Platzhalter macht eine ansonsten erforderliche Auswahl nicht löschbar.
Anfangszeilen des Repeaters
Im Editor umfassen Standardwerte verschachtelte Mindestzeilen, bevor der Block eingefügt wird. Du musst die Blockeinstellungen nicht öffnen, um sie zu initialisieren, und durch das Einfügen des Blocks entsteht für diese Zeilen kein zusätzlicher Rückgängig-Schritt.
Wenn ein Repeater min hat, aber keinen gespeicherten Wert und kein explizites default, initialisiert der Server entsprechend viele Zeilen mit den Standardwerten der Zeilenfelder. Das gilt auch für PHP-Einbettungen, Block-Tags und dateibasierte Seitenquellen, die noch nie im Editor geöffnet wurden. Beispiel: "min": 2 mit einem Textfeld, dessen Standardwert "New item" ist, gibt zwei Zeilen mit diesem Wert aus.
Gespeicherte Zeilen und ein explizites default des Repeaters haben Vorrang. Eine explizit gespeicherte leere Liste, false oder null stellt entfernte Zeilen nicht wieder her. Beim Rendern werden diese generierten Standardwerte nicht in den Beitrag zurückgeschrieben. min und max begrenzen die Steuerelemente im Editor; sie kürzen oder ergänzen eine gespeicherte Liste beim Rendern nicht. Verwende bs_validate_block(), um Verletzungen der Zeilenbegrenzung in importierten Inhalten zu melden.
Zeilenfelder ohne default sind in einer generierten Zeile false und haben daher keinen Inhalt. Von Editoren hinzugefügte und leer gelassene Zeilen sehen genauso aus. Eine Vorlage, die für jede Zeile eine Karte, eine Überschrift oder ein Listenelement ausgibt, sollte Zeilen ohne Inhalt außerhalb des Editors überspringen und sie im Editor beibehalten, damit ihre Felder bearbeitbar bleiben:
<?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; ?>
Entfernen von Repeatern
Beim Entfernen einer Zeile öffnet sich der Bestätigungsdialog des Editors mit den Schaltflächen Löschen und Abbrechen. Mit Abbrechen oder Escape bleibt die Zeile unverändert. Sie wird erst nach der Bestätigung entfernt, auch in verschachtelten Repeatern.
textRemove steuert dasselbe Verhalten für alle Repeater:
| Wert | Verhalten |
|---|---|
Nicht angegeben, true oder "" |
Zeigt die standardmäßige Bestätigungsfrage an. |
| Eine nicht leere Zeichenfolge | Zeigt diese benutzerdefinierte Frage über den bestehenden Übersetzungsmechanismus für benutzerdefinierte Texte an. |
false |
Entfernt die Zeile sofort ohne Dialog. |
Beispielsweise ändert "textRemove": "Remove this team member?" die Frage.
Die bestehende Einschränkung min verhindert weiterhin das Entfernen von Zeilen unterhalb des Minimums.
Verschachtelung von Repeaters
Eine Repeater-Zeile akzeptiert jeden Feldtyp außer tabs. Ein tabs-Feld in einer Zeile, auch innerhalb einer Gruppe ohne id, zeigt im Editor einen Hinweis statt seiner Felder an. Die Erweiterung PHPStan meldet dies für block.json und field.json. Halte die Felder der Zeile flach oder verschiebe die Tabs aus dem Repeater heraus.
WYSIWYG-Links
Die Link-Symbolleiste von WYSIWYG fügt standardmäßig Links ein, die im selben Tab geöffnet werden, ohne target oder rel hinzuzufügen. Aktiviere die Option zum Öffnen in einem neuen Tab mit toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Wenn ein neuer Tab ausgewählt wird, kommen target="_blank" und rel="noreferrer noopener" hinzu.
Beim Deaktivieren werden diese automatisch gesetzten Attribute entfernt. Um Attribute auf jeden Link in diesem Feld anzuwenden, setze toolbar.formats.link.attributes, zum Beispiel
{ "class": "content-link", "rel": "nofollow" }. Eine explizite Konfiguration bleibt erhalten, und die Sicherheits-Token für neue Tabs werden zu den konfigurierten rel hinzugefügt.
Die Eingabe eines URL wandelt ihn nicht automatisch in einen Link um, und ein Klick auf einen bestehenden Link im Feld führt nicht aus dem Editor heraus. Bereits gespeicherte Link-Attribute bleiben in bestehenden Inhalten erhalten; sie werden nicht automatisch migriert.