Atributy bloku
Proměnné $attributes nebo $a umožňují přístup pouze k datům zaregistrovaným ve vlastnosti blockstudio. Ke standardním datům bloku WordPress, jako je zarovnání nebo typografie, získáte přístup pomocí proměnných $block nebo $b.
Vykreslování
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>
Nastavení výchozích hodnot
Rezervovaná ID polí
Atributy spravované WordPress se nesmějí deklarovat jako pole Blockstudio se stejným ID nejvyšší úrovně. Rezervované jsou položky anchor, className, style, lock a metadata, stejně jako interní atributy blockstudio, __BLOCKSTUDIO_KEY a blockEditingMode v rámci Blockstudio.
Povolené podpory WordPress si také rezervují názvy svých atributů: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow a ariaLabel, podle toho, které jsou použity. Stejný název rezervuje i nativní deklarace jednoho z těchto atributů. Tím se například zabrání nahrazení řetězce align z jádra objektem s možnostmi výběrového pole.
Konfliktní pole se při registraci přeskočí a zaznamenají prostřednictvím blockstudio/error/logged (a při zapnutí ladicího protokolu WordPress), přičemž se uvede název bloku a pole. Neregistrují se jejich ovládací prvky editoru, obslužné rutiny úložiště ani definice vykreslení. Přejmenujte pole na headingAlign nebo je vložte do pojmenované skupiny, například presentation, čímž vznikne presentation_align. Pole opakovače žijí uvnitř svého řádku, a proto nejsou kolizemi na nejvyšší úrovni. Běžné pole align zůstává platné, když je podpora zarovnání vypnutá a neexistuje žádný nativní atribut align.
Při upgradu existujícího bloku s kolizí přejmenujte jeho pole a přesuňte všechny uložené hodnoty pole na nové ID. Blockstudio potichu nepřejmenovává uložený obsah ani neodebírá podporu WordPress.
Výchozí hodnoty nativních atributů
Chcete-li nastavit výchozí hodnotu pro vlastnosti WordPress, například align, přidejte klíč default do klíče 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
}
Dostupná data bloku
Proměnná $block / $b obsahuje:
| Vlastnost | Popis |
|---|---|
name |
Název bloku (e.g, my-theme/my-block) |
title |
Název bloku |
dir |
Cesta k adresáři bloku |
url |
URL adresáře bloku |
align |
Hodnota zarovnání (pokud je povoleno supports.align) |
className |
Vlastní třída CSS (pokud je povoleno supports.customClassName) |
anchor |
Kotva/ID HTML (pokud je povoleno supports.anchor) |
Podpora WordPress
Zapněte funkce bloků WordPress prostřednictvím vlastnosti supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Všechny dostupné možnosti najdete v dokumentaci podpory bloků WordPress Block Supports.