Атрибуты блока
Переменные $attributes или $a дают доступ только к данным, зарегистрированным в свойстве blockstudio. Для доступа к стандартным данным блока WordPress, например выравниванию или типографике, используйте переменные $block или $b.
Рендеринг
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>
Настройка значений по умолчанию
Зарезервированные 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:
{
"$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:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Полный список доступных параметров см. в документации WordPress о поддержке блоков.