Zum Inhalt springen

Varianten

Die Block-Variation API ermöglicht es dir, eigene Variationen für vorhandene Blöcke zu registrieren.

Stell dir einen Block vor, der je nach Wert eines einfachen Select-Felds zwei verschiedene Varianten haben soll.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/variations",
  "title": "Native Variation",
  "description": "Native Blockstudio Variation block.",
  "icon": "star-filled",
  "variations": [
    {
      "name": "variation-2",
      "title": "Native Variation 2",
      "description": "Native Blockstudio Variation block 2.",
      "attributes": {
        "select": {
          "value": "variation-2"
        }
      }
    }
  ],
  "blockstudio": {
    "attributes": [
      {
        "id": "select",
        "type": "select",
        "label": "Select",
        "options": [
          {
            "value": "variation-1",
            "label": "Variation 1"
          },
          {
            "value": "variation-2",
            "label": "Variation 2"
          }
        ],
        "default": {
          "value": "variation-1"
        }
      }
    ]
  }
}

Damit erscheinen im Inserter drei Blöcke: der Hauptblock und zwei Varianten.

Attribute ausblenden

Attribute rendern in der Seitenleiste automatisch die passenden Eingabefelder. Da Variantenblöcke von bestimmten Attributwerten abhängen, möchtest du diese Felder vielleicht aus der Seitenleiste ausblenden. Verwende dafür die Option hidden.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "select",
        "type": "select",
        "label": "Select",
        "hidden": true,
        "options": [
          {
            "value": "variation-1",
            "label": "Variation 1"
          },
          {
            "value": "variation-2",
            "label": "Variation 2"
          }
        ]
      }
    ]
  }
}