Перейти до вмісту

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

Змінні $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>

Налаштування значень за замовчуванням

Зарезервовані ідентифікатори полів

Атрибути, що належать 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:

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 щодо підтримки блоків.