Vai al contenuto

Interattività

Blockstudio supporta WordPress Interactivity API, che offre un modo standard per aggiungere comportamenti reattivi lato client ai vostri blocchi. Impostate interactivity nel vostro block.json e Blockstudio si occupa di caricare API sia nel frontend sia nell’editor.

Configurazione

Abilitate le direttive Interactivity API aggiungendo interactivity alla chiave blockstudio nel vostro block.json:

JSON
{
  "name": "my-theme/interactive-block",
  "title": "Interactive Block",
  "category": "text",
  "icon": "star-filled",
  "description": "A block with interactive behavior.",
  "blockstudio": {
    "interactivity": true
  }
}

Potete usare anche la forma a oggetto:

JSON
{
  "blockstudio": {
    "interactivity": {
      "enqueue": true
    }
  }
}

Le due forme sono equivalenti.

Template

Aggiungete le direttive Interactivity API al template del vostro blocco. L’attributo data-wp-interactive definisce lo namespace dello store, mentre gli altri attributi data-wp-* controllano il comportamento reattivo.

PHP
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>

Script

Create un file script.js nella cartella del vostro blocco che importi da @wordpress/interactivity e inizializzi lo store. Chiamate store() al livello principale del modulo:

JavaScript
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});

Blockstudio carica script.js come modulo ES e genera automaticamente l’importmap necessario per risolvere @wordpress/interactivity.

script.js è necessario solo se il blocco definisce azioni o callback personalizzate. I blocchi che usano solo direttive dichiarative con data-wp-context (come data-wp-bind--hidden o data-wp-text) funzionano senza JavaScript.

Stato lato server

Potete usare wp_interactivity_state() nel template per inizializzare lo stato da PHP:

PHP
<?php
wp_interactivity_state( 'myBlock', array(
    'message' => 'Hello from the server',
    'count'   => get_comments_number(),
) );
?>
<div useBlockProps
     data-wp-interactive="myBlock">
  <p data-wp-text="state.message">loading...</p>
  <p data-wp-text="state.count">0</p>
</div>

Lo stato lato server è disponibile solo nel frontend. WordPress serializza lo stato in un tag script JSON nell’output della pagina, che l’API di interattività legge durante l’hydration. Nell’editor, i blocchi vengono renderizzati tramite REST API, quindi i dati dello stato non sono inclusi nella risposta. Usate data-wp-context per lo stato che deve funzionare sia nell’editor sia nel frontend.

Callback e azioni

Le azioni vengono attivate dalle interazioni dell’utente (come data-wp-on--click). Le callback si attivano in modo reattivo quando cambia lo stato o il contesto, usando la direttiva data-wp-watch. All’interno delle callback, potete chiamare getElement() per accedere all’elemento DOM sottostante:

JavaScript
import { store, getContext, getElement } from '@wordpress/interactivity';

store('myBlock', {
  callbacks: {
    updateWidth: () => {
      const { ref } = getElement();
      const { isOpen } = getContext();
      ref.style.width = isOpen ? '100%' : '0';
    },
  },
});

Supporto nell’editor

L’API di interattività viene caricato nell’iframe dell’editor a blocchi, quindi le direttive interattive funzionano nelle anteprime dell’editor. Sono incluse data-wp-context, data-wp-bind--*, data-wp-on--*, data-wp-text e le azioni personalizzate dello store definite in script.js.

Creazione di componenti interattivi

Esempi completi con pannelli a fisarmonica, schede, finestre modali e pulsanti Mi piace.