Атрибути блока
Змінні $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>
Налаштування значень за замовчуванням
Зарезервовані ідентифікатори полів
Атрибути, що належать WordPress, не можна оголошувати як поля Blockstudio з таким самим ідентифікатором верхнього рівня. Зарезервовано 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 щодо підтримки блоків.