Przejdź do treści

Atrybuty bloku

Zmienne $attributes lub $a zapewniają dostęp tylko do danych zarejestrowanych we właściwości blockstudio. Aby uzyskać dostęp do standardowych danych bloku WordPress, takich jak wyrównanie lub typografia, użyj zmiennych $block lub $b.

Renderowanie

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>

Ustawianie wartości domyślnych

Zarezerwowane identyfikatory pól

Atrybutów zarządzanych przez WordPress nie wolno deklarować jako pól Blockstudio z tym samym identyfikatorem najwyższego poziomu. Zarezerwowane są anchor, className, style, lock i metadata, podobnie jak wewnętrzne atrybuty blockstudio, __BLOCKSTUDIO_KEY i blockEditingMode w Blockstudio.

Włączone obsługiwane przez WordPress funkcje również rezerwują nazwy swoich atrybutów: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow i ariaLabel, zależnie od przypadku. Natywna deklaracja jednego z tych atrybutów również rezerwuje jego nazwę. Zapobiega to na przykład zastąpieniu tekstowego align rdzenia obiektem opcji pola wyboru.

Konfliktujące pola są pomijane podczas rejestracji, a ich nazwy bloków i pól są zapisywane w dzienniku za pomocą blockstudio/error/logged (oraz dziennika debugowania WordPress, jeśli jest włączony). Ich kontrolki edytora, procedury obsługi zapisu i definicje renderowania nie są rejestrowane. Zmień nazwę pola na headingAlign albo umieść je w nazwanej grupie, takiej jak presentation, aby uzyskać presentation_align. Pola wierszy powtarzacza znajdują się wewnątrz wiersza i nie kolidują z polami najwyższego poziomu. Zwykłe pole align pozostaje prawidłowe, gdy obsługa wyrównania jest wyłączona i nie istnieje natywny atrybut align.

Podczas aktualizacji istniejącego bloku z kolizją zmień nazwę jego pola i przenieś wszystkie zapisane wartości pola do nowego identyfikatora. Blockstudio nie zmienia po cichu nazw zapisanej treści ani nie usuwa obsługi WordPress.

Natyślne wartości domyślne atrybutów

Aby ustawić wartość domyślną właściwości WordPress, takich jak align, dodaj klucz default wewnątrz klucza 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
}

Dostępne dane bloku

Zmienna $block / $b zawiera:

Właściwość Opis
name Nazwa bloku (e.g., my-theme/my-block)
title Tytuł bloku
dir Ścieżka katalogu bloku
url URL katalogu bloku
align Wartość wyrównania (jeśli włączono supports.align)
className Niestandardowa klasa CSS (jeśli włączono supports.customClassName)
anchor Kotwica/identyfikator HTML (jeśli włączono supports.anchor)

Obsługa WordPress

Włącz funkcje bloków WordPress za pomocą właściwości supports:

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

Pełną listę dostępnych opcji znajdziesz w WordPressdokumentacji obsługi bloków.