{"id":82886,"date":"2026-01-09T09:48:52","date_gmt":"2026-01-09T08:48:52","guid":{"rendered":"https:\/\/kinsta.com\/it\/?p=82886&preview=true&preview_id=82886"},"modified":"2026-01-12T13:42:29","modified_gmt":"2026-01-12T12:42:29","slug":"api-block-bindings-wordpress","status":"publish","type":"post","link":"https:\/\/kinsta.com\/it\/blog\/api-block-bindings-wordpress\/","title":{"rendered":"L’API WordPress Block Bindings: cos’\u00e8 e come usarla per costruire siti web dinamici"},"content":{"rendered":"

L’API Block Bindings \u00e8 un potente strumento dell’editor a blocchi che permette di associare qualsiasi fonte di dati agli attributi di un blocco.<\/p>\n

Questa API \u00e8 stata introdotta per la prima volta in WordPress 6.5<\/a> e, nella sua<\/span> implementazione iniziale<\/span>, permetteva agli utenti di WordPress di visualizzare i valori dei campi personalizzati all’interno dei post e delle pagine.<\/p>\n

L’API Block Bindings funge da base per altre funzioni di WordPress. Ne sono un esempio gli override dei pattern sincronizzati<\/a> e la variazione del blocco Post Date<\/strong> introdotta in WordPress 6.9<\/a>.<\/p>\n

Quindi, cos’\u00e8 esattamente l’API Block Bindings? E a cosa serve? Ecco qui una semplice introduzione e un esempio reale che mostra come creare associazioni tra i blocchi di Gutenberg e le fonti di dati esterne.<\/p>\n

Mettiamoci al lavoro.
\n

<\/div><\/kinsta-auto-toc><\/p>\n

L’API Block Bindings: concetti di base<\/h2>\n

Come abbiamo detto in precedenza, l’API Block Bindings permette di creare associazioni tra una fonte di dati e gli attributi di un blocco.<\/p>\n

Se non hai familiarit\u00e0 con gli attributi dei blocchi, naviga nella directory src<\/code> della libreria dei blocchi del progetto Gutenberg su GitHub, trova il blocco Paragraph e apri il file block.json<\/code><\/a>. La propriet\u00e0 attributes<\/code> fornisce un elenco degli attributi del blocco Paragraph.<\/p>\n

\"attributes\": {\n\t\"content\": {\n\t\t\"type\": \"rich-text\",\n\t\t\"source\": \"rich-text\",\n\t\t\"selector\": \"p\",\n\t\t\"role\": \"content\"\n\t},\n\t\"dropCap\": {\n\t\t\"type\": \"boolean\",\n\t\t\"default\": false\n\t},\n\t\"placeholder\": {\n\t\t\"type\": \"string\"\n\t},\n\t\"direction\": {\n\t\t\"type\": \"string\",\n\t\t\"enum\": [ \"ltr\", \"rtl\" ]\n\t}\n},<\/code><\/pre>\n
I seguenti blocchi supportano l’API Block Bindings a partire da WordPress 6.9 e possono quindi essere collegati ai campi personalizzati:<\/p>\n\n\n\n\n\n\n\n\n
Blocchi supportati<\/th>\nAttributi<\/th>\n<\/tr>\n<\/thead>\n
Paragrafo<\/td>\ncontenuto<\/td>\n<\/tr>\n
Titolo<\/td>\ncontenuto<\/td>\n<\/tr>\n
Immagine<\/td>\nid, url, alt, titolo, didascalia<\/td>\n<\/tr>\n
Pulsante<\/td>\ntesto, url, linkTarget, rel<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Per collegare i campi personalizzati ai blocchi di Gutenberg, bisogna prima registrarli<\/a>. Il codice seguente registra un campo personalizzato tramite un plugin di WordPress o il file functions.php<\/code><\/a> del tuo tema:<\/p>\n
add_action( 'init', function() {\n\tregister_post_meta( 'your-post-type', 'myplugin_meta_key', [\n\t\t'show_in_rest'  => true,\n\t\t'single'        => true,\n\t\t'type'          => 'string',\n\t\t'description'   => __( 'City name', 'textdomain' ),\n\t\t'auth_callback' => 'is_user_logged_in',\n\t] );\n} );<\/code><\/pre>\n
register_post_meta<\/code> accetta un array di attributi che definiscono le caratteristiche dei campi personalizzati; la documentazione ne fornisce un elenco completo<\/a>. Per rendere un campo personalizzato disponibile all’API Block Bindings, \u00e8 necessario impostare show_in_rest<\/code> su true. A partire da WordPress 6.9, string<\/code> \u00e8 l’unico tipo supportato.<\/p>\n
Per vedere l’API Block Bindings in azione con i campi personalizzati, crea un nuovo plugin WordPress e registra un meta-campo con il codice mostrato sopra.<\/p>\n
<?php\n\/**\n * Plugin Name: Block Bindings example\n * Description: Example plugin that uses the Block Bindings API.\n * Version: 1.0.0\n * Author: Your Name\n * License: GPL2 or later\n * Text Domain: block-bindings-example\n *\/\n\nif ( ! defined( 'ABSPATH' ) ) {\n\texit;\n}\n\nadd_action( 'init', function() {\n\tregister_post_meta( '', 'block_bindings_image_url', [\n\t\t'show_in_rest'  => true,\n\t\t'single'\t    => true,\n\t\t'type'\t\t    => 'string',\n\t\t'description'   => __( 'City name', 'block-bindings-example' ),\n\t\t'auth_callback' => 'is_user_logged_in',\n\t] );\n} );<\/code><\/pre>\n
Nella dashboard di WordPress, attiva il plugin. Poi, vai nella schermata Messaggi e crea un nuovo post. Quando selezioni un blocco supportato, il pannello Attributi<\/strong> nella barra laterale delle impostazioni del blocco visualizzer\u00e0 l’elenco degli attributi che possono essere associati a un campo personalizzato registrato.<\/p>\n
\"Uno
Attributi del blocco immagine che supportano le associazioni del blocco<\/figcaption><\/figure>\n
Apri il menu Opzioni<\/strong> nell’angolo in alto a destra e seleziona Preferenze<\/strong>. Nella scheda Generale<\/strong>, individua la sezione Avanzate<\/strong> e attiva i campi personalizzati. Salva le modifiche, attendi che la pagina venga ricaricata e torna all’editor.<\/p>\n
\"Uno
Abilita i campi personalizzati nelle Preferenze dell’editor.<\/figcaption><\/figure>\n