# Додавайте поля до будь-якого блоку

Чистий JSON. Без шаблонів і функцій зворотного виклику для рендерингу.

## Власні поля без шаблонів

Створіть файл JSON, виберіть цільовий блок за допомогою `name` і визначте поля. `set` зіставляє значення з класами, стилями, атрибутами даних або будь-яким іншим атрибутом HTML.

Blockstudio застосовує вихідні дані за допомогою обробника тегів WordPress HTML. Без шаблонів і функцій зворотного виклику для рендерингу.

[Основи розширення](https://blockstudio.dev/uk/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}"
        }]
      }
    ]
  }
}
```

## Будь-який цільовий блок

Розширюйте блок, список або всі елементи простору імен за шаблоном.

## Властивість set

Зіставляйте поля з класами, стилями, атрибутами даних або будь-яким атрибутом HTML.

## Умовні поля

Показуйте поля відповідно до інших значень за логікою, як у блоках.

## Повний набір можливостей

Усі типи полів, умовна логіка, динамічне заповнення та властивості.

## Розташування в панелі інспектора

Розміщуйте поля на вкладках налаштувань, стилів або розширених параметрів.

## Порядок за пріоритетом

Визначайте порядок кількох розширень, націлених на той самий блок.

## Без функцій зворотного виклику для рендерингу

Обробник тегів HTML автоматично застосовує вихідні дані.

## JSON Schema

Окрема схема для автодоповнення й перевірки.

## Зіставляйте значення з HTML за допомогою set

`set` зіставляє значення з класами, вбудованими стилями, атрибутами даних або будь-яким атрибутом HTML за допомогою нотації з крапкою, наприклад `{attributes.fieldId}`.

Отримуйте вкладені значення об’єктів, застосовуйте їх за умовою або виводьте одне поле в кілька атрибутів.

Якщо поле повертає кілька значень, до кожного з них застосовується `set`. Класи й стилі додаються, а для будь-якого іншого атрибута `"join": true` записує всі значення через пробіл замість того, щоб залишити лише останнє.

[Властивість set](https://blockstudio.dev/uk/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" }
        ]
      }
    ]
  }
}
```

## Вибирайте один блок або тисячі

Виберіть одну назву, як-от `"core/paragraph"`, масив назв або весь простір імен за допомогою `"core/*"`.

Кілька розширень JSON можуть бути націлені на той самий блок. Пріоритет визначає їхній порядок у панелі інспектора.

Список `exclude` верхнього рівня пропускає блоки, які збігаються з `name`, за допомогою такого самого точного зіставлення та зіставлення за шаблоном. Виключений блок не отримує ні полів, ні їхнього виводу.

[Вибір цільових блоків](https://blockstudio.dev/uk/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" }
        ]
      }
    ]
  }
}
```

## Виключити блоки

Пропускайте окремі блоки або цілі префікси, які інакше збігалися б із шаблоном.

## Об’єднання значень

Записуйте всі вибрані значення поля з кількома значеннями в один атрибут.

## Поле атрибутів

Поле атрибутів додає до блоку пари назв і значень без заданого правила.

## Перевірка за допомогою PHP

bs_block_extension_fields() повертає поля, які кожне відповідне розширення додає до блоку, зокрема до стандартних блоків і блоків сторонніх розробників.

Plus

## Офіційний набір розширень

Преміумшаблони сайтів, системні інструкції для ШІ та приватна спільнота Discord. Одноразова покупка, довічні оновлення.

- Понад 500 шаблонів сайтів
- Системні інструкції для ШІ
- Оновлення назавжди
- Приватна спільнота Discord

[Отримати Plus](https://blockstudio.dev/uk/plus/)
