Перейти к содержимому

Атрибуты блока

Переменные $attributes или $a дают доступ только к данным, зарегистрированным в свойстве blockstudio. Для доступа к стандартным данным блока WordPress, например выравниванию или типографике, используйте переменные $block или $b.

Рендеринг

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>

Настройка значений по умолчанию

Зарезервированные ID полей

Атрибуты, управляемые WordPress, нельзя объявлять полями Blockstudio с тем же ID верхнего уровня. Зарезервированы anchor, className, style, lock и metadata, а также внутренние атрибуты blockstudio, __BLOCKSTUDIO_KEY и blockEditingMode у Blockstudio.

Включенные поддержки WordPress тоже резервируют имена своих атрибутов: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow и ariaLabel, если применимо. Нативное объявление одного из этих атрибутов также резервирует его имя. Это предотвращает, например, замену строкового align ядра объектом параметров поля выбора.

Конфликтующие поля пропускаются при регистрации, а сведения о них записываются через blockstudio/error/logged (и журнал отладки WordPress, если он включен) с указанием блока и поля. Их элементы управления в редакторе, обработчики хранения и определения для отрисовки не регистрируются. Переименуйте поле в headingAlign или поместите его в именованную группу, например presentation, чтобы получить presentation_align. Поля строки повторителя находятся внутри этой строки и не конфликтуют с полями верхнего уровня. Обычное поле align остается допустимым, если поддержка выравнивания отключена и нативного атрибута align нет.

При обновлении существующего блока с конфликтующим полем переименуйте его и перенесите все сохранённые значения этого поля на новый идентификатор. Blockstudio не переименовывает сохранённое содержимое автоматически и не удаляет поддержку WordPress.

Встроенные значения атрибутов по умолчанию

Чтобы задать значение по умолчанию для свойств WordPress, например align, добавьте ключ default внутри ключа 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
}

Доступные данные блока

Переменная $block / $b содержит:

Свойство Описание
name Название блока (e.g., my-theme/my-block)
title Заголовок блока
dir Путь к каталогу блока
url URL каталога блока
align Значение выравнивания (если включено supports.align)
className Пользовательский класс CSS (если включено supports.customClassName)
anchor Якорь/ID HTML (если включено supports.anchor)

Поддержка WordPress

Включите возможности блока WordPress через свойство supports:

JSON
{
  "supports": {
    "align": true,
    "anchor": true,
    "customClassName": true,
    "color": {
      "background": true,
      "text": true
    },
    "spacing": {
      "margin": true,
      "padding": true
    },
    "typography": {
      "fontSize": true,
      "lineHeight": true
    }
  }
}

Полный список доступных параметров см. в документации WordPress о поддержке блоков.