Block-Attribute
Die Variablen $attributes oder $a geben dir nur Zugriff auf Daten, die in der Eigenschaft blockstudio registriert sind. Um auf Standarddaten von WordPress-Blöcken wie Ausrichtung oder Typografie zuzugreifen, verwende die Variablen $block oder $b.
Rendering
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
Standardwerte festlegen
Reservierte Feld-IDs
Von WordPress verwaltete Attribute dürfen nicht als Blockstudio-Felder mit derselben ID auf oberster Ebene deklariert werden. anchor, className, style, lock und metadata sind reserviert, ebenso die internen Attribute blockstudio, __BLOCKSTUDIO_KEY und blockEditingMode von Blockstudio.
Aktivierte WordPress-Unterstützungen reservieren ihre Attributnamen ebenfalls: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow und ariaLabel, sofern zutreffend. Eine native Deklaration eines dieser Attribute reserviert den Namen ebenfalls. Dadurch wird beispielsweise verhindert, dass core’s String align durch das Optionsobjekt eines Auswahlfelds ersetzt wird.
Widersprüchliche Felder werden bei der Registrierung übersprungen und über blockstudio/error/logged protokolliert (sowie im WordPress-Debugprotokoll, wenn aktiviert); dabei werden Block und Feld genannt. Ihre Editor-Steuerelemente, Speicherhandler und Renderdefinitionen werden nicht registriert. Benenne das Feld in headingAlign um oder platziere es in einer benannten Gruppe wie presentation, um presentation_align zu erzeugen. Felder in Repeater-Zeilen befinden sich innerhalb ihrer Zeile und verursachen keine Kollisionen auf oberster Ebene. Ein gewöhnliches align-Feld bleibt gültig, wenn die Ausrichtungsunterstützung deaktiviert ist und kein natives align-Attribut existiert.
Wenn du einen bestehenden Block mit einer Kollision aktualisierst, benenne sein Feld um und migriere alle gespeicherten Feldwerte zur neuen ID. Blockstudio benennt gespeicherte Inhalte nicht stillschweigend um und entfernt auch nicht die Unterstützung für WordPress.
Native Standardwerte für Attribute
Um einen Standardwert für WordPress-Eigenschaften wie align festzulegen, füge einen Schlüssel default innerhalb des Schlüssels attributes hinzu:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
Verfügbare Blockdaten
Die Variable $block / $b enthält:
| Eigenschaft | Beschreibung |
|---|---|
name |
Blockname (e.g., my-theme/my-block) |
title |
Blocktitel |
dir |
Pfad zum Blockverzeichnis |
url |
URL des Blockverzeichnisses |
align |
Ausrichtungswert (wenn supports.align aktiviert ist) |
className |
Benutzerdefinierte CSS-Klasse (wenn supports.customClassName aktiviert ist) |
anchor |
HTML-Anker/ID (wenn supports.anchor aktiviert ist) |
WordPress-Unterstützungen
Aktiviere WordPress-Blockfunktionen über die Eigenschaft supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Alle verfügbaren Optionen findest du in der Dokumentation zu WordPress Block Supports.