Vai al contenuto

Attributi dei blocchi

Le variabili $attributes o $a consentono di accedere solo ai dati registrati nella proprietà blockstudio. Per accedere ai dati standard dei blocchi WordPress, come allineamento o tipografia, usate le variabili $block o $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>

Impostare i valori predefiniti

ID di campo riservati

Gli attributi gestiti da WordPress non devono essere dichiarati come campi Blockstudio con lo stesso ID di primo livello. anchor, className, style, lock e metadata sono riservati, così come gli attributi interni blockstudio, __BLOCKSTUDIO_KEY e blockEditingMode di Blockstudio.

Anche i supporti WordPress abilitati riservano i rispettivi nomi di attributo: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow e ariaLabel, se applicabile. Anche una dichiarazione nativa di uno di questi attributi ne riserva il nome. In questo modo, per esempio, la stringa align di core non viene sostituita dall’oggetto delle opzioni di un campo di selezione.

I campi in conflitto vengono ignorati in fase di registrazione e segnalati tramite blockstudio/error/logged (e nel log di debug WordPress, se attivo), indicando il blocco e il campo. I relativi controlli dell’editor, gestori di archiviazione e definizioni di rendering non vengono registrati. Rinominare il campo con headingAlign oppure inserirlo in un gruppo con nome, come presentation, per ottenere presentation_align. I campi delle righe di un ripetitore si trovano all’interno della rispettiva riga e non causano conflitti di primo livello. Un normale campo align resta valido quando il supporto per l’allineamento è disattivato e non esiste un attributo nativo align.

Quando aggiornate un blocco esistente che presenta una collisione, rinominate il suo campo e migrate gli eventuali valori salvati al nuovo ID. Blockstudio non rinomina automaticamente i contenuti memorizzati né rimuove il supporto WordPress.

Valori predefiniti degli attributi nativi

Per impostare un valore predefinito per le proprietà WordPress, come align, aggiungete una chiave default all’interno della chiave attributes:

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
}

Dati dei blocchi disponibili

La variabile $block / $b contiene:

Proprietà Descrizione
name Nome del blocco (e.g., my-theme/my-block)
title Titolo del blocco
dir Percorso della directory del blocco
url URL della directory del blocco
align Valore di allineamento (se supports.align è abilitato)
className Classe CSS personalizzata (se supports.customClassName è abilitato)
anchor Ancora/ID HTML (se supports.anchor è abilitato)

Funzionalità supportate da WordPress

Abilitate le funzionalità dei blocchi WordPress tramite la proprietà supports:

JSON
{
  "supports": {
    "align": true,
    "anchor": true,
    "customClassName": true,
    "color": {
      "background": true,
      "text": true
    },
    "spacing": {
      "margin": true,
      "padding": true
    },
    "typography": {
      "fontSize": true,
      "lineHeight": true
    }
  }
}

Consultate la documentazione di WordPressBlock Supports per tutte le opzioni disponibili.