Към съдържанието

Атрибути на блокове

Променливите $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, __BLOCKSTUDIO_KEY и blockEditingMode.

Поддръжката на активирани WordPress също запазва имената на атрибутите им: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow и ariaLabel, когато е приложимо. Естествена декларация на някой от тези атрибути също запазва това име. Така например низовият align на ядрото няма да бъде заменен с обект с опции от поле за избор.

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

Когато надграждате съществуващ блок с колизия, преименувайте полето му и мигрирайте всички запазени стойности на полето към новия ID. 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 за всички налични опции.