# Adicione campos a qualquer bloco

Apenas JSON. Sem templates nem callbacks de renderização.

## Campos personalizados, zero templates

Crie um arquivo JSON, direcione um bloco com `name` e defina os campos. `set` mapeia valores para classes, estilos, atributos de dados ou qualquer outro atributo HTML.

Blockstudio aplica a saída com o WordPress HTML Tag Processor. Sem templates nem callbacks de renderização.

[Noções básicas sobre extensões](https://blockstudio.dev/pt/docs/extensions/)

extend-animation.json

```
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "allowNull": "None",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ],
        "set": [{
          "attribute": "class",
          "value": "animate-{attributes.animation}"
        }]
      }
    ]
  }
}
```

## Direcione para qualquer bloco

Estenda um bloco, uma lista ou um curinga de namespace.

## A propriedade set

Mapeie campos para classes, estilos, atributos de dados ou qualquer atributo HTML.

## Campos condicionais

Mostre campos com base em outros valores usando lógica no estilo de blocos.

## Conjunto completo de recursos

Todos os tipos de campo, lógica condicional, populações e propriedades.

## Posicionamento do inspetor

Coloque campos nas abas de configurações, estilos ou avançado.

## Ordenação por prioridade

Ordene várias extensões direcionadas ao mesmo bloco.

## Sem callbacks de renderização

O HTML Tag Processor aplica a saída automaticamente.

## JSON Schema

Preenchimento automático e validação com esquema dedicado.

## Mapeie valores para HTML com set

`set` mapeia valores para classes, estilos em linha, atributos de dados ou qualquer atributo HTML usando notação de pontos, como `{attributes.fieldId}`.

Acesse valores de objetos aninhados, aplique-os condicionalmente ou gere um campo em vários atributos.

Um campo que retorna vários valores aplica `set` a cada um deles. Classes e estilos são acumulados; para qualquer outro atributo, `"join": true` grava todos os valores, separados por espaços, em vez de manter apenas o último.

[A propriedade set](https://blockstudio.dev/pt/docs/extensions/#attributes)

extend-color.json

```
{
  "name": "core/heading",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "returnFormat": "both",
        "options": [
          { "value": "#f00", "label": "Red" },
          { "value": "#00f", "label": "Blue" }
        ],
        "set": [
          { "attribute": "style", "value": "color: {attributes.customColor.value}" },
          { "attribute": "data-color", "value": "{attributes.customColor.label}" },
          { "attribute": "class", "value": "has-custom-color" }
        ]
      }
    ]
  }
}
```

## Direcione um bloco ou milhares

Direcione um nome, como `"core/paragraph"`, uma matriz de nomes ou um namespace inteiro com `"core/*"`.

Várias extensões JSON podem direcionar o mesmo bloco. A prioridade controla a ordem no inspetor.

Uma lista `exclude` no nível superior ignora os blocos que `name` corresponderia, usando a mesma correspondência exata e com curingas. Um bloco excluído não recebe os campos nem sua saída.

[Direcionamento de blocos](https://blockstudio.dev/pt/docs/extensions/)

extend-animation.json

```
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ]
      }
    ]
  }
}
```

## Excluir blocos

Ignore blocos individuais ou prefixos inteiros que, de outra forma, corresponderiam a um curinga.

## Valores concatenados

Grave todos os valores selecionados de um campo com vários valores em um único atributo.

## Campo de atributos

Um campo de atributos grava seus pares de nome e valor no bloco sem uma regra definida.

## Inspecione por meio de PHP

bs_block_extension_fields() retorna os campos que cada extensão correspondente adiciona a um bloco, incluindo os blocos do núcleo e de terceiros.

Plus

## O kit oficial de extensões

Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.

- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord

[Obter Plus](https://blockstudio.dev/pt/plus/)
