Livro de receitas de padrões de campos
O sistema de campos de Blockstudio é simples quando considerado isoladamente: adicione um campo a blockstudio.attributes e acesse-o por $a no seu modelo. Mas blocos reais raramente têm apenas um campo. Eles têm grupos de configurações relacionadas, campos que aparecem ou desaparecem conforme outros campos, repetidores com estruturas de linhas complexas e dados que precisam ser consultáveis fora do editor de blocos.
Este guia reúne receitas práticas para padrões comuns de campos. Cada receita mostra a configuração block.json e o código correspondente do modelo. Copie-as diretamente para seus blocos e adapte conforme necessário.
Campos condicionais
O padrão mais comum: mostrar ou ocultar campos com base no valor de outro campo. Isso mantém o editor organizado, exibindo apenas as opções relevantes.
Alternância para revelar opções
Um bloco CTA em que configurações adicionais aparecem quando o usuário ativa um botão:
{
"name": "my-theme/cta",
"title": "Call to Action",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Ready to get started?" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "showButton", "type": "toggle", "label": "Show Button", "default": true },
{
"id": "buttonText",
"type": "text",
"label": "Button Text",
"default": "Get Started",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
},
{
"id": "buttonUrl",
"type": "link",
"label": "Button Link",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
}
]
}
}
Os campos de texto e link do botão só aparecem quando a alternância está ativada. No modelo, verifique a alternância antes de renderizar:
<div useBlockProps>
<h2><?php echo esc_html( $a['heading'] ); ?></h2>
<?php if ( $a['description'] ) : ?>
<p><?php echo esc_html( $a['description'] ); ?></p>
<?php endif; ?>
<?php if ( $a['showButton'] && $a['buttonUrl'] ) : ?>
<a href="<?php echo esc_url( $a['buttonUrl']['url'] ); ?>">
<?php echo esc_html( $a['buttonText'] ); ?>
</a>
<?php endif; ?>
</div>
Seleção para alternar conjuntos de campos
Um bloco de destaque em que o tipo de plano de fundo determina quais campos aparecem:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{
"id": "bgType",
"type": "select",
"label": "Background Type",
"default": "color",
"options": [
{ "value": "color", "label": "Solid Color" },
{ "value": "gradient", "label": "Gradient" },
{ "value": "image", "label": "Image" },
{ "value": "video", "label": "Video" }
]
},
{
"id": "bgColor",
"type": "color",
"label": "Background Color",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "color" }]]
},
{
"id": "bgGradient",
"type": "gradient",
"label": "Background Gradient",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "gradient" }]]
},
{
"id": "bgImage",
"type": "files",
"label": "Background Image",
"multiple": false,
"conditions": [[{ "id": "bgType", "operator": "==", "value": "image" }]]
},
{
"id": "bgVideo",
"type": "files",
"label": "Background Video",
"multiple": false,
"allowedTypes": ["video"],
"conditions": [[{ "id": "bgType", "operator": "==", "value": "video" }]]
},
{
"id": "overlay",
"type": "range",
"label": "Overlay Opacity",
"default": 50,
"min": 0,
"max": 100,
"conditions": [[{ "id": "bgType", "operator": "!=", "value": "color" }]]
}
]
}
}
O campo de opacidade da sobreposição usa != para aparecer em todos os casos, exceto quando a cor é sólida. Apenas um campo de plano de fundo é exibido por vez. Um campo color retorna um array com o value, o name e o slug da cor, então o modelo lê ['value']:
<?php
$bg_style = match ( $a['bgType'] ) {
'color' => $a['bgColor'] ? "background-color: {$a['bgColor']['value']}" : '',
'gradient' => $a['bgGradient'] ? "background: {$a['bgGradient']}" : '',
'image' => $a['bgImage'] ? "background-image: url({$a['bgImage']['url']})" : '',
default => '',
};
?>
<div useBlockProps style="<?php echo esc_attr( $bg_style ); ?>">
<?php if ( $a['bgType'] === 'video' && $a['bgVideo'] ) : ?>
<video autoplay muted loop playsinline>
<source src="<?php echo esc_url( $a['bgVideo']['url'] ); ?>" />
</video>
<?php endif; ?>
<h1><?php echo esc_html( $a['heading'] ); ?></h1>
</div>
Condições OR
Mostre um campo quando qualquer uma de várias condições for verdadeira. Cada array interno é um grupo AND; o array externo combina esses grupos com OR:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Isso exibe o campo de legenda quando bgType é “image” OU “video”.
Condições encadeadas
Várias condições no mesmo array interno usam a lógica AND:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
O campo de texto alternativo só aparece quando bgType é “image” E uma imagem foi selecionada.
Condições globais
Exiba campos com base no tipo de publicação, no ID da publicação ou na função do usuário, em vez de usar valores de outros campos:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Tipos de condição global disponíveis: postType, postId, userRole, userId.
Configurações organizadas
À medida que os blocos ficam mais complexos, organizar os campos em grupos lógicos mantém o inspetor fácil de usar.
Grupos para organização visual
Os grupos criam seções recolhíveis no inspetor. Um grupo anônimo (sem id) é puramente visual; os campos são acessados pelos IDs simples:
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"attributes": [
{
"type": "group",
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "image", "type": "files", "label": "Image", "multiple": false }
]
},
{
"type": "group",
"title": "Link",
"attributes": [
{ "id": "url", "type": "link", "label": "URL" },
{ "id": "openInNewTab", "type": "toggle", "label": "Open in New Tab" }
]
},
{
"type": "group",
"title": "Appearance",
"attributes": [
{
"id": "style",
"type": "select",
"label": "Style",
"default": "elevated",
"options": [
{ "value": "elevated", "label": "Elevated" },
{ "value": "outlined", "label": "Outlined" },
{ "value": "flat", "label": "Flat" }
]
},
{ "id": "accentColor", "type": "color", "label": "Accent Color" }
]
}
]
}
}
<div useBlockProps>
<h3><?php echo esc_html( $a['title'] ); ?></h3>
<p><?php echo esc_html( $a['description'] ); ?></p>
</div>
Os campos são acessados diretamente: $a['title'], $a['style'], $a['accentColor']. Os grupos afetam apenas o layout do inspetor.
Grupos nomeados com bs_get_group
Quando um grupo tem um id, os IDs dos campos filhos recebem esse prefixo. Use bs_get_group() para removê-lo:
{
"id": "author",
"type": "group",
"title": "Author",
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "avatar", "type": "files", "label": "Avatar", "multiple": false }
]
}
Sem o auxiliar, os campos são acessados como $a['author_name'], $a['author_role'], $a['author_avatar']. Com o auxiliar:
<?php $author = bs_get_group( $a, 'author' ); ?>
<div class="author">
<?php if ( $author['avatar'] ) : ?>
<img src="<?php echo esc_url( $author['avatar']['url'] ); ?>" alt="" />
<?php endif; ?>
<p><?php echo esc_html( $author['name'] ); ?></p>
<p><?php echo esc_html( $author['role'] ); ?></p>
</div>
Grupos nomeados são úteis quando os mesmos nomes de campo aparecem em vários grupos (e.g., author_name e company_name) ou quando você quer passar o grupo inteiro para um modelo parcial.
Layout em grade nos grupos
Use a propriedade style para organizar os campos filhos do grupo lado a lado:
{
"type": "group",
"title": "Dimensions",
"style": {
"display": "grid",
"grid-template-columns": "1fr 1fr",
"grid-gap": "16px"
},
"attributes": [
{ "id": "width", "type": "unit", "label": "Width", "default": "100%", "switch": false },
{ "id": "height", "type": "unit", "label": "Height", "default": "auto", "switch": false }
]
}
Os dois campos de unidade são exibidos lado a lado no inspetor, em vez de empilhados. Isso funciona bem para pares de dimensões, valores de margem/preenchimento ou quaisquer dois campos que formem um par conceitual.
Abas para seções principais
Quando um bloco tem muitas configurações, as abas organizam melhor o conteúdo do que uma longa lista de grupos:
{
"type": "tabs",
"tabs": [
{
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "body", "type": "wysiwyg", "label": "Body" }
]
},
{
"title": "Media",
"attributes": [
{ "id": "image", "type": "files", "label": "Image", "multiple": false },
{ "id": "video", "type": "files", "label": "Video", "multiple": false, "allowedTypes": ["video"] }
]
},
{
"title": "Settings",
"attributes": [
{ "id": "layout", "type": "select", "label": "Layout", "options": [
{ "value": "left", "label": "Media Left" },
{ "value": "right", "label": "Media Right" }
]},
{ "id": "fullWidth", "type": "toggle", "label": "Full Width" }
]
}
]
}
Os campos de cada aba são acessados como campos de nível superior: $a['title'], $a['image'], $a['layout']. As abas são apenas um contêiner UI.
Padrões de repetidores
Os repetidores permitem que os usuários adicionem várias linhas de campos. Eles são essenciais para listas, grades, cronologias e qualquer componente com um número variável de itens.
Repetidor básico com restrições
Uma lista de recursos com 1 a 6 itens:
{
"id": "features",
"type": "repeater",
"label": "Features",
"min": 1,
"max": 6,
"textButton": "Add Feature",
"attributes": [
{ "id": "icon", "type": "icon", "label": "Icon" },
{ "id": "title", "type": "text", "label": "Title", "default": "Feature" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
<div useBlockProps class="grid grid-cols-3 gap-8">
<?php foreach ( $a['features'] as $feature ) : ?>
<div>
<?php if ( $feature['icon'] ) : ?>
<?php bs_render_icon( $feature['icon'] ); ?>
<?php endif; ?>
<h3><?php echo esc_html( $feature['title'] ); ?></h3>
<p><?php echo esc_html( $feature['description'] ); ?></p>
</div>
<?php endforeach; ?>
</div>
Rótulos personalizados para linhas
Por padrão, as linhas minimizadas do repetidor exibem um rótulo genérico. Use textMinimized para exibir o valor de um campo:
{
"id": "team",
"type": "repeater",
"label": "Team Members",
"textMinimized": { "id": "name", "fallback": "Team Member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "photo", "type": "files", "label": "Photo", "multiple": false }
]
}
Quando uma linha é recolhida, ela exibe o nome da pessoa em vez de “Row 1”. fallback é usado quando o campo de nome está vazio. Você também pode adicionar as strings prefix e suffix.
Condições dentro de repetidores
Os campos dentro de um repetidor podem fazer referência a outros campos na mesma linha usando seus id simples (não é necessário prefixo):
{
"id": "links",
"type": "repeater",
"label": "Links",
"attributes": [
{ "id": "label", "type": "text", "label": "Label" },
{ "id": "url", "type": "link", "label": "URL" },
{
"id": "isExternal",
"type": "toggle",
"label": "External Link"
},
{
"id": "externalNote",
"type": "message",
"label": "Note",
"description": "External links open in a new tab with rel=\"noopener\".",
"conditions": [[{ "id": "isExternal", "operator": "==", "value": true }]]
}
]
}
Referenciar campos externos de dentro de um repetidor
Quando uma condição dentro de um repetidor precisa verificar um campo externo ao repetidor, adicione "context": "main":
{
"id": "showDescriptions",
"type": "toggle",
"label": "Show Descriptions",
"default": true
},
{
"id": "items",
"type": "repeater",
"label": "Items",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{
"id": "description",
"type": "textarea",
"label": "Description",
"conditions": [[{
"id": "showDescriptions",
"operator": "==",
"value": true,
"context": "main"
}]]
}
]
}
Sem "context": "main", a condição procuraria um campo showDescriptions dentro da linha do repetidor. Com ele, a condição verifica a alternância no nível raiz.
Abas dentro de repetidores
Abas não estão disponíveis dentro de repetidores: um campo tabs dentro de uma linha do repetidor exibe um aviso no editor em vez de seus campos, e a extensão PHPStan informa isso. Mantenha simples os campos de uma linha. Para linhas longas, um rótulo personalizado (textMinimized) mantém as linhas recolhidas legíveis; as condições dentro da linha podem ocultar campos necessários apenas em algumas linhas, como mostrado nos padrões acima.
Defina "minimized": true em um repetidor para iniciar com as linhas existentes recolhidas. As linhas recém-adicionadas são abertas imediatamente. As exceções expandidas são lembradas neste navegador entre recarregamentos do editor; essa é uma preferência de edição, não conteúdo salvo da publicação.
Repetidores sem minimized mantêm o comportamento existente de iniciar expandidos.
Padrões de mídia
Imagem única com alternativa
{
"id": "image",
"type": "files",
"label": "Image",
"multiple": false
}
<?php if ( $a['image'] ) : ?>
<img
src="<?php echo esc_url( $a['image']['url'] ); ?>"
alt="<?php echo esc_attr( $a['image']['alt'] ); ?>"
<?php if ( isset( $a['image']['sizes']['full-width'], $a['image']['sizes']['full-height'] ) ) : ?>
width="<?php echo esc_attr( $a['image']['sizes']['full-width'] ); ?>"
height="<?php echo esc_attr( $a['image']['sizes']['full-height'] ); ?>"
<?php endif; ?>
/>
<?php endif; ?>
O padrão de returnFormat é "object", que fornece ID, title, alt, caption, description, href, url e sizes. sizes contém o URL de cada tamanho de imagem registrado (sizes['large']) com suas dimensões (sizes['large-width'], sizes['large-height']). Consulte Atributos de renderização para ver a lista completa.
Galeria com limite
{
"id": "gallery",
"type": "files",
"label": "Gallery",
"multiple": true,
"max": 6,
"allowedTypes": ["image"]
}
<?php if ( $a['gallery'] ) : ?>
<div class="grid grid-cols-3 gap-4">
<?php foreach ( $a['gallery'] as $image ) : ?>
<img
src="<?php echo esc_url( $image['url'] ); ?>"
alt="<?php echo esc_attr( $image['alt'] ); ?>" />
<?php endforeach; ?>
</div>
<?php endif; ?>
Imagem desativável com controle de alternância
A propriedade switch adiciona um ícone de olho que permite aos usuários desativar o campo sem excluir o valor:
{
"id": "logo",
"type": "files",
"label": "Logo",
"multiple": false,
"switch": true
}
<?php
$is_disabled = ! empty( $a['_disabled'] ) && in_array( 'logo', $a['_disabled'], true );
if ( $a['logo'] && ! $is_disabled ) : ?>
<img src="<?php echo esc_url( $a['logo']['url'] ); ?>" alt="" />
<?php endif; ?>
O usuário pode desativar o logotipo sem remover o arquivo enviado. Ao reativá-lo, o mesmo arquivo volta a aparecer.
Variações do formato de retorno
Controle o que o campo de arquivos retorna:
// Full object (default)
{ "id": "photo", "type": "files", "returnFormat": "object", "multiple": false }
// $a['photo']['url'], $a['photo']['alt'], $a['photo']['sizes']['full-width'], etc.
// Just the ID
{ "id": "photo", "type": "files", "returnFormat": "id", "multiple": false }
// $a['photo'] = 42
// Just the URL
{ "id": "photo", "type": "files", "returnFormat": "url", "multiple": false }
// $a['photo'] = "https://example.com/photo.jpg"
Use "id" quando precisar chamar wp_get_attachment_image() por conta própria. Use "url" para imagens de fundo simples. Use "object" (o padrão) para todo o resto.
Com "returnFormat": "id", uma referência de string importada, como "buckshair-home", é passada sem alterações. O editor exibe um cartão substituto sem miniatura, inclusive nas linhas do repetidor. Abrir ou salvar a página não converte uma referência escalar em um array. Listas mistas de IDs de anexos e referências de string também funcionam; apenas IDs de anexos positivos são pesquisados na biblioteca de mídia.
Blockstudio não associa referências de string personalizadas a anexos. Associe-as em seu próprio filtro de renderização ou template quando usar nomes portáteis entre sites. Escolher uma substituição na biblioteca de mídia armazena o ID do anexo como de costume.
Opções dinâmicas
Preencher a partir de publicações
Um campo de seleção que lista todas as páginas publicadas:
{
"id": "linkedPage",
"type": "select",
"label": "Linked Page",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "page",
"post_status": "publish",
"posts_per_page": -1
}
}
}
O campo é preenchido automaticamente com títulos de páginas como rótulos e IDs de publicações como valores. Use returnFormat na configuração de preenchimento para personalizar o mapeamento:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Preencher a partir de termos de taxonomia
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Preencher a partir de uma função PHP
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Opções estáticas com adições preenchidas dinamicamente
Combine opções predefinidas com opções dinâmicas. Use position para controlar onde as opções preenchidas aparecem:
{
"id": "source",
"type": "select",
"label": "Source",
"options": [
{ "value": "manual", "label": "Manual Entry" },
{ "value": "latest", "label": "Latest Posts" }
],
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"position": "after"
}
}
As opções estáticas aparecem primeiro, seguidas pelas páginas preenchidas dinamicamente.
Armazenar dados para consultas
Por padrão, os valores dos campos ficam nos atributos de bloco dentro de post_content. Eles não podem ser consultados com WP_Query. Quando precisar filtrar ou ordenar publicações por um valor de campo, use o armazenamento.
Metadados de publicação para campos consultáveis
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
},
{
"id": "priority",
"type": "number",
"label": "Priority",
"default": 0,
"min": 0,
"max": 100,
"storage": {
"type": "postMeta",
"postMetaKey": "priority_score"
}
}
Agora você pode consultar publicações em destaque:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
As chaves de metadados são registradas automaticamente com show_in_rest, então também ficam disponíveis na REST API.
Armazenamento duplo
Armazene tanto nos atributos de bloco quanto nos metadados da publicação. O atributo de bloco mantém o valor disponível nos modelos por meio de $a, enquanto os metadados da publicação permitem consultá-lo:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Armazenamento em opções para valores globais
Para configurações de todo o site que devem ser iguais em todos os lugares, use o armazenamento em opções:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
O valor é armazenado em wp_options e pode ser acessado de qualquer lugar com get_option('site_company_name'). Quando o usuário edita esse campo em qualquer instância do bloco, o valor é atualizado globalmente.
Definições de campos reutilizáveis
Quando vários blocos compartilham a mesma estrutura de campos, defina-a uma vez como campo personalizado e faça referência a ela em todos os lugares.
Criar um campo personalizado
Crie um field.json no diretório blockstudio/fields/ do seu tema:
theme/
└── blockstudio/
└── fields/
└── cta/
└── field.json
{
"name": "cta",
"title": "Call to Action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button Label", "default": "Learn More" },
{ "id": "url", "type": "link", "label": "Button URL" },
{ "id": "style", "type": "select", "label": "Button Style", "default": "primary", "options": [
{ "value": "primary", "label": "Primary" },
{ "value": "secondary", "label": "Secondary" },
{ "value": "outline", "label": "Outline" }
]}
]
}
Usar o campo personalizado
Faça referência a ele em qualquer bloco com "type": "custom/cta":
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
Os campos CTA são incorporados ao bloco. Acesse-os diretamente: $a['label'], $a['url'], $a['style'].
Campos personalizados com prefixo usando idStructure
Ao usar o mesmo campo personalizado várias vezes, adicione idStructure para prefixar os IDs:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
Os campos da primeira CTA se tornam primary_label, primary_url, primary_style. Os da segunda se tornam secondary_label etc.
Substituir padrões
Personalize campos específicos ao fazer referência a um campo personalizado:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
As substituições são mescladas à definição original. Você pode alterar valores padrão, rótulos, condições ou qualquer outra propriedade.
Padrões de renderização
Verificações de valores vazios
A maioria dos tipos de campo retorna false quando vazia. Sempre verifique antes de renderizar:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
Para números, 0 é um valor válido. Use uma comparação estrita se precisar distinguir entre “vazio” e “zero”:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Seleção com returnFormat: both
Quando precisar tanto do valor (para lógica) quanto do rótulo (para exibição):
{
"id": "status",
"type": "select",
"label": "Status",
"returnFormat": "both",
"options": [
{ "value": "active", "label": "Active" },
{ "value": "paused", "label": "On Hold" },
{ "value": "closed", "label": "Closed" }
]
}
<?php if ( $a['status'] ) : ?>
<span class="badge badge--<?php echo esc_attr( $a['status']['value'] ); ?>">
<?php echo esc_html( $a['status']['label'] ); ?>
</span>
<?php endif; ?>
Atributos de dados do campo attributes
O tipo de campo attributes permite que os usuários adicionem atributos de dados personalizados:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
Variáveis CSS a partir de valores de campos
Gere propriedades personalizadas CSS a partir dos campos selecionados:
{
"id": "textColor", "type": "color", "label": "Text Color"
},
{
"id": "fontSize", "type": "unit", "label": "Font Size", "default": "1rem"
}
<div useBlockProps style="<?php bs_render_variables( $a, array( 'textColor', 'fontSize' ) ); ?>">
<p>Styled content.</p>
</div>
Isso gera style="--text-color: #333; --font-size: 1rem;" (os IDs dos campos são convertidos para kebab-case). Use as variáveis no seu CSS:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Próximas etapas
- Registro de atributos: as propriedades
id,type,label,default,help,positioneconditions. - Referência de tipos de campo: referência gerada automaticamente com todas as propriedades de cada tipo de campo.
- Lógica condicional: operadores, condições globais, filtros de condição personalizados e contexto do repetidor.
- Preenchimento de opções: modos de consulta, função, personalizado e busca para campos de opções dinâmicas.
- Campos personalizados:
field.json, caminhos de descoberta, o filtroblockstudio/fieldse padrões avançados deidStructure. - Renderização:
$a,$b,$c, valores vazios e funções auxiliares.