Vai al contenuto

Varianti

Il Varianti di bloccoAPI consente di registrare varianti personalizzate per blocchi esistenti.

Immaginiamo un blocco che dovrebbe avere due varianti diverse in base al valore di un semplice campo di selezione.

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"
        }
      }
    ]
  }
}

Quanto sopra creerà tre blocchi nell’inseritore: quello principale e due varianti.

Nascondere gli attributi

Gli attributi generano automaticamente il campo di input appropriato nella barra laterale. Poiché le varianti dei blocchi dipendono da valori specifici degli attributi, potreste voler nascondere quei campi nella barra laterale. Per farlo, potete usare l’opzione 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"
          }
        ]
      }
    ]
  }
}