Pular para o conteúdo

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

PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>

Twig

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:

JSON
{
  "$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:

JSON
{
  "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.