Atribúty bloku
Premenné $attributes alebo $a umožňujú prístup iba k údajom zaregistrovaným vo vlastnosti blockstudio. Ak chcete získať prístup k štandardným údajom bloku WordPress, ako je zarovnanie alebo typografia, použite premenné $block alebo $b.
Vykresľovanie
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>
Nastavenie predvolených hodnôt
Vyhradené ID polí
Atribúty spravované cez WordPress sa nesmú deklarovať ako polia Blockstudio s rovnakým ID najvyššej úrovne. Vyhradené sú anchor, className, style, lock a metadata, rovnako ako interné atribúty blockstudio, __BLOCKSTUDIO_KEY a blockEditingMode spravované cez Blockstudio.
Aj funkcie WordPress, ktoré sú zapnuté, si vyhradzujú názvy svojich atribútov: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow a ariaLabel podľa potreby. Aj natívna deklarácia niektorého z týchto atribútov rezervuje jeho názov. Tým sa predíde napríklad nahradeniu textovej hodnoty align jadra objektom s možnosťami výberového poľa.
Konfliktné polia sa pri registrácii preskočia a zaznamenajú cez blockstudio/error/logged (a pri zapnutom ladení aj do diagnostického záznamu WordPress), pričom sa uvedie názov bloku a poľa. Ich ovládacie prvky editora, obslužné rutiny úložiska a definície vykreslenia sa nezaregistrujú. Premenujte pole na headingAlign alebo ho vložte do pomenovanej skupiny, napríklad presentation, aby vzniklo presentation_align. Polia riadkov opakovača sú v rámci svojho riadka, a preto nekolidujú s poľami najvyššej úrovne. Bežné pole align zostáva platné, keď je podpora zarovnania vypnutá a neexistuje natívny atribút align.
Pri aktualizácii existujúceho bloku s kolíziou premenujte jeho pole a preneste všetky uložené hodnoty poľa na nové ID. Blockstudio potichu nepremenuje uložený obsah ani neodstráni podporu WordPress.
Predvolené hodnoty natívnych atribútov
Ak chcete nastaviť predvolenú hodnotu vlastností WordPress, napríklad align, pridajte kľúč default do kľúča 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é údaje bloku
Premenná $block / $b obsahuje:
| Vlastnosť | Opis |
|---|---|
name |
Názov bloku (e.g., my-theme/my-block) |
title |
Názov bloku |
dir |
Cesta k priečinku bloku |
url |
URL priečinka bloku |
align |
Hodnota zarovnania (ak je zapnutá možnosť supports.align) |
className |
Vlastná trieda CSS (ak je zapnutá možnosť supports.customClassName) |
anchor |
Kotva/ID HTML (ak je zapnutá možnosť supports.anchor) |
Podporované funkcie WordPress
Zapnite funkcie bloku WordPress pomocou 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šetky dostupné možnosti nájdete v dokumentácii o podpore blokov BlockWordPress.