Zum Inhalt springen

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.

Field Patterns Cookbook

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

Zeigt ein Link-Steuerelement zur Auswahl interner oder externer Links an.

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

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

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

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

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

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

JSON
{
  "type": "tabs"
}

Eigenschaften

Eigenschaft Typ Beschreibung
tabs array Anzuzeigende Tabs.

Text

Zeigt ein einzeiliges Texteingabefeld an.

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

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

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

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

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

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

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

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:

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