Atributos de bloco
As variáveis $attributes ou $a só dão acesso aos dados registrados na propriedade blockstudio. Para acessar dados padrão de bloco do WordPress, como alinhamento ou tipografia, use as variáveis $block ou $b.
Renderização
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>
Definir valores padrão
IDs de campo reservados
Atributos controlados por WordPress não devem ser declarados como campos Blockstudio com o mesmo ID de nível superior. anchor, className, style, lock e metadata são reservados, assim como os atributos internos blockstudio, __BLOCKSTUDIO_KEY e blockEditingMode de Blockstudio.
Os suportes WordPress ativados também reservam os nomes de seus atributos: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow e ariaLabel, conforme aplicável. Uma declaração nativa de um desses atributos também reserva esse nome. Isso evita substituir, por exemplo, a string align do núcleo por um objeto de opções de um campo de seleção.
Campos conflitantes são ignorados durante o registro e registrados por meio de blockstudio/error/logged (e no log de depuração WordPress, quando ativado), com o nome do bloco e do campo. Seus controles do editor, manipuladores de armazenamento e definições de renderização não são registrados. Renomeie o campo para headingAlign ou coloque-o dentro de um grupo nomeado, como presentation, para produzir presentation_align. Os campos de linhas do Repeater ficam dentro da própria linha e não causam conflitos no nível superior. Um campo align comum continua válido quando o suporte a alinhamento está desativado e não existe um atributo nativo align.
Ao atualizar um bloco existente com uma colisão, renomeie o campo e migre os valores salvos do campo para o novo ID. Blockstudio não renomeia silenciosamente o conteúdo armazenado nem remove o suporte a WordPress.
Valores padrão nativos de atributos
Para definir um valor padrão para propriedades WordPress como align, adicione uma chave default dentro da chave 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
}
Dados de bloco disponíveis
A variável $block / $b contém:
| Propriedade | Descrição |
|---|---|
name |
Nome do bloco (e.g., my-theme/my-block) |
title |
Título do bloco |
dir |
Caminho do diretório do bloco |
url |
URL do diretório do bloco |
align |
Valor do alinhamento (se supports.align estiver ativado) |
className |
Classe CSS personalizada (se supports.customClassName estiver ativado) |
anchor |
Âncora/ID HTML (se supports.anchor estiver ativado) |
Compatibilidade com WordPress
Ative os recursos de bloco WordPress pela propriedade supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Consulte a documentação de WordPress compatibilidade de blocos para ver todas as opções disponíveis.