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