{"id":74079,"date":"2026-01-09T05:57:25","date_gmt":"2026-01-09T08:57:25","guid":{"rendered":"https:\/\/kinsta.com\/pt\/?p=74079&preview=true&preview_id=74079"},"modified":"2026-01-15T08:13:45","modified_gmt":"2026-01-15T11:13:45","slug":"api-vinculacao-blocos-wordpress","status":"publish","type":"post","link":"https:\/\/kinsta.com\/pt\/blog\/api-vinculacao-blocos-wordpress\/","title":{"rendered":"A API de vincula\u00e7\u00e3o de blocos do WordPress: o que \u00e9 e como us\u00e1-la para criar sites din\u00e2micos"},"content":{"rendered":"

A API de vincula\u00e7\u00e3o de blocos \u00e9 uma ferramenta poderosa do editor de blocos que permite conectar qualquer fonte de dados aos atributos de um bloco.<\/p>\n

Essa API foi introduzida pela primeira vez no WordPress 6.5<\/a> e, em sua<\/span> implementa\u00e7\u00e3o inicial<\/span>, permitiu que os usu\u00e1rios do WordPress exibissem valores de campos personalizados em artigos e p\u00e1ginas.<\/p>\n

A API de vincula\u00e7\u00e3o de blocos serve como base para outros recursos robustos do WordPress. Entre os exemplos est\u00e3o as substitui\u00e7\u00f5es de padr\u00f5es sincronizados<\/a> e a varia\u00e7\u00e3o do bloco Data do artigo<\/strong>\u00a0introduzida no WordPress 6.9<\/a>.<\/p>\n

Ent\u00e3o, afinal, o que \u00e9 a API de vincula\u00e7\u00e3o de blocos? E para que ela \u00e9 usada? A seguir, apresentamos uma introdu\u00e7\u00e3o simples e um exemplo do mundo real mostrando como criar v\u00ednculos entre blocos do Gutenberg e fontes de dados externas.<\/p>\n

Vamos come\u00e7ar.
\n

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

A API de vincula\u00e7\u00e3o de blocos: conceitos b\u00e1sicos<\/h2>\n

Como mencionado acima, a API de vincula\u00e7\u00e3o de blocos permite criar v\u00ednculos entre uma fonte de dados e os atributos de um bloco.<\/p>\n

Se voc\u00ea n\u00e3o estiver familiarizado com atributos de blocos, navegue at\u00e9 o diret\u00f3rio src<\/code> da biblioteca de blocos do projeto Gutenberg no GitHub, localize o bloco Par\u00e1grafo e abra o arquivo block.json<\/code><\/a>. A propriedade attributes<\/code> fornece uma lista dos atributos do bloco Par\u00e1grafo.<\/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
Os blocos a seguir s\u00e3o compat\u00edveis com a API de vincula\u00e7\u00e3o de blocos a partir do WordPress 6.9 e, portanto, podem ser vinculados aos seus campos personalizados:<\/p>\n\n\n\n\n\n\n\n\n
Blocos compat\u00edveis<\/th>\nAtributos<\/th>\n<\/tr>\n<\/thead>\n
Par\u00e1grafo<\/td>\nconte\u00fado<\/td>\n<\/tr>\n
T\u00edtulo<\/td>\nconte\u00fado<\/td>\n<\/tr>\n
Imagem<\/td>\nid, url, alt, t\u00edtulo, legenda<\/td>\n<\/tr>\n
Bot\u00e3o<\/td>\ntexto, url, linkTarget, rel<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Para conectar seus campos personalizados aos blocos do Gutenberg, voc\u00ea deve primeiro registr\u00e1-los<\/a>. O c\u00f3digo a seguir registra um campo personalizado por meio de um plugin do WordPress ou do arquivo functions.php<\/code><\/a> do seu 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> aceita um array de atributos que definem as caracter\u00edsticas dos campos personalizados, e a documenta\u00e7\u00e3o fornece uma lista completa<\/a> deles. Para tornar um campo personalizado dispon\u00edvel para a API de vincula\u00e7\u00e3o de blocos, \u00e9 necess\u00e1rio definir show_in_rest<\/code> como true<\/code>. A partir do WordPress 6.9, string<\/code> \u00e9 o \u00fanico tipo compat\u00edvel.<\/p>\n
Para ver a API de vincula\u00e7\u00e3o de blocos em a\u00e7\u00e3o com campos personalizados, crie um novo plugin do WordPress e registre um campo meta com o c\u00f3digo mostrado acima.<\/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
No painel do WordPress, ative o plugin. Em seguida, navegue at\u00e9 a tela Artigos e crie um novo artigo. Ao selecionar um bloco compat\u00edvel, o painel Atributos<\/strong> na barra lateral de Configura\u00e7\u00f5es do bloco exibir\u00e1 a lista de atributos que podem ser vinculados a um campo personalizado registrado.<\/p>\n
\"Atributos
Atributos do bloco de Imagem compat\u00edveis com a vincula\u00e7\u00e3o de blocos.<\/figcaption><\/figure>\n
Abra o menu Op\u00e7\u00f5es<\/strong> no canto superior direito e selecione Prefer\u00eancias<\/strong>. Na aba Geral<\/strong>, localize a se\u00e7\u00e3o Avan\u00e7ado<\/strong> e ative campos personalizados. Salve as altera\u00e7\u00f5es, aguarde at\u00e9 que a p\u00e1gina recarregue e retorne ao editor.<\/p>\n
\"Prefer\u00eancias
Habilitar campos personalizados em Prefer\u00eancias do editor.<\/figcaption><\/figure>\n