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
<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>
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:
{
"$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:
{
"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.