Blokkattribútumok
A $attributes vagy $a változóval csak a blockstudio tulajdonságban regisztrált adatok érhetők el. Az igazításhoz vagy tipográfiához hasonló szabványos WordPress blokkadatok eléréséhez használja a $block vagy a $b változót.
Renderelés
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>
Alapértelmezett értékek beállítása
Fenntartott mezőazonosítók
A WordPress által kezelt attribútumokat nem szabad ugyanazzal a legfelső szintű azonosítóval rendelkező Blockstudio mezőként deklarálni. A anchor, className, style, lock és metadata, valamint a Blockstudio belső blockstudio, __BLOCKSTUDIO_KEY és blockEditingMode attribútumai fenntartottak.
Az engedélyezett WordPress támogatások attribútumnevei szintén fenntartottak: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow és ariaLabel, ha alkalmazhatók. Ezen attribútumok natív deklarációja szintén fenntartja az adott nevet. Így például a core szöveges align attribútumát nem írja felül egy választómező opcióobjektuma.
Az ütköző mezőket a rendszer kihagyja a regisztrációkor, és a blockstudio/error/logged segítségével naplózza (ha engedélyezve van, a WordPress hibakeresési naplóba is), megnevezve a blokkot és a mezőt. A mező szerkesztővezérlői, tárolókezelői és megjelenítési definíciói nem kerülnek regisztrálásra. Nevezze át a mezőt erre: headingAlign, vagy helyezze el egy névvel ellátott csoportban, például presentation, így a létrejövő érték: presentation_align.
Az ismétlő sorainak mezői a soron belül találhatók, ezért nem okoznak legfelső szintű ütközést. Egy szokásos align mező akkor is érvényes marad, ha az igazítás támogatása ki van kapcsolva, és nincs natív align attribútum.
Ha ütközést okozó meglévő blokkot frissít, nevezze át a mezőjét, és migrálja az összes mentett mezőértéket az új azonosítóra. A Blockstudio nem nevezi át észrevétlenül a tárolt tartalmat, és nem távolítja el a WordPress támogatását.
Natív attribútumalapértelmezések
Az olyan WordPress tulajdonságok alapértelmezett értékének megadásához, mint a align, adjon meg egy default kulcsot a attributes kulcson belül:
{
"$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
}
Elérhető blokkadatok
A $block / $b változó a következőket tartalmazza:
| Tulajdonság | Leírás |
|---|---|
name |
Blokknév (e.g, my-theme/my-block) |
title |
Blokk címe |
dir |
A blokk könyvtárának elérési útja |
url |
A blokk könyvtárának URL értéke |
align |
Igazítási érték (ha a supports.align engedélyezve van) |
className |
Egyéni CSS osztály (ha a supports.customClassName engedélyezve van) |
anchor |
HTML horgony/azonosító (ha a supports.anchor engedélyezve van) |
WordPress támogatása
Engedélyezze a WordPress blokkfunkciókat a supports tulajdonságon keresztül:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Az elérhető beállításokért tekintse meg a WordPress blokkfunkciók dokumentációját.