Zum Inhalt springen

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

PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>

Twig

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:

JSON
{
  "$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:

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