Ploki atribuudid
Muutujad $attributes või $a annavad juurdepääsu ainult andmetele, mis on registreeritud atribuudi blockstudio all. Standardsetele WordPress plokiandmetele, näiteks joondusele või tüpograafiale, juurdepääsemiseks kasutage muutujaid $block või $b.
Renderdamine
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>
Vaikeväärtuste määramine
Reserveeritud välja-ID-d
WordPress hallatavaid atribuute ei tohi määrata Blockstudio väljadena sama ülataseme ID-ga. Reserveeritud on anchor, className, style, lock ja metadata, samuti Blockstudio sisemised atribuudid blockstudio, __BLOCKSTUDIO_KEY ja blockEditingMode.
Lubatud WordPress tugi reserveerib vajaduse korral ka nende atribuutide nimed: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow ja ariaLabel. Nime reserveerib ka mõne sellise atribuudi natiivne deklaratsioon. Nii välditakse näiteks core’i tekstilise align asendamist valikuvälja valikute objektiga.
Vastuolulised väljad jäetakse registreerimisel vahele ja neist antakse teada logi kaudu blockstudio/error/logged (ning lubatud WordPress silumislogis), kus nimetatakse plokk ja väli. Nende redaktori juhtelemente, salvestuskäitlureid ega renderdusmääratlusi ei registreerita. Nimetage väli ümber kujule headingAlign või paigutage see nimetatud rühma, näiteks presentation, et saada presentation_align. Kordaja rea väljad asuvad oma reas ega põhjusta ülataseme konflikte. Tavaline align väli kehtib ka siis, kui joondustugi on keelatud ja natiivset atribuuti align pole.
Uuendades olemasolevat plokki, milles tekib konflikt, nimetage selle väli ümber ja viige kõik salvestatud välja väärtused üle uuele ID-le. Blockstudio ei nimeta salvestatud sisu vaikselt ümber ega eemalda WordPress tuge.
Natiivsed atribuudi vaikeväärtused
Atribuutide WordPress vaikeväärtuse (nt align) määramiseks lisage võtme attributes sisse võti default:
{
"$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
}
Saadaolevad plokiandmed
Muutuja $block / $b sisaldab järgmist:
| Atribuut | Kirjeldus |
|---|---|
name |
Ploki nimi (e.g, my-theme/my-block) |
title |
Ploki pealkiri |
dir |
Ploki kataloogi tee |
url |
Ploki kataloogi URL |
align |
Joondusväärtus (kui supports.align on lubatud) |
className |
Kohandatud CSS-klass (kui supports.customClassName on lubatud) |
anchor |
HTML ankur/ID (kui supports.anchor on lubatud) |
WordPress tugi
Lubage ploki WordPress funktsioonid atribuudi supports kaudu:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Kõigi saadaolevate valikute kohta leiate teavet dokumentatsioonist WordPress Block Supports.