Atributi blokov
Spremenljivki $attributes ali $a omogočata dostop samo do podatkov, registriranih v lastnosti blockstudio. Za dostop do standardnih podatkov bloka WordPress, kot sta poravnava ali tipografija, uporabite spremenljivki $block ali $b.
Izrisovanje
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>
Nastavitev privzetih vrednosti
Rezervirani ID-ji polj
Atributi, ki jih upravlja WordPress, ne smejo biti deklarirani kot polja Blockstudio z enakim ID-jem na najvišji ravni. Rezervirani so anchor, className, style, lock in metadata, prav tako pa tudi notranji atributi blockstudio, __BLOCKSTUDIO_KEY in blockEditingMode v Blockstudio.
Omogočena podpora WordPress prav tako rezervira ustrezna imena atributov: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow in ariaLabel, kadar je to ustrezno. Tudi izvorna deklaracija enega od teh atributov rezervira njegovo ime. Tako se na primer nizovni atribut align jedra ne zamenja z objektom možnosti izbirnega polja.
Nasprotujoča se polja so pri registraciji preskočena, o njih pa se zabeleži sporočilo prek blockstudio/error/logged (in dnevnika za razhroščevanje WordPress, kadar je ta omogočen); navedena sta blok in polje. Njihovi kontrolniki urejevalnika, upravljalniki shranjevanja in definicije izrisa niso registrirani. Preimenujte polje v headingAlign ali ga postavite v poimenovano skupino, kot je presentation, da dobite presentation_align. Polja vrstic ponavljalnika so znotraj svoje vrstice in ne povzročajo konfliktov na najvišji ravni. Običajno polje align ostane veljavno, kadar je podpora za poravnavo onemogočena in izvorni atribut align ne obstaja.
Pri nadgradnji obstoječega bloka s kolizijo preimenujte njegovo polje in preselite vse shranjene vrednosti polja na novi ID. Blockstudio shranjene vsebine ne preimenuje samodejno in ne odstrani podpore za WordPress.
Privzete vrednosti izvornih atributov
Če želite nastaviti privzeto vrednost za lastnosti WordPress, kot je align, dodajte ključ default znotraj ključ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
}
Razpoložljivi podatki bloka
Spremenljivka $block / $b vsebuje:
| Lastnost | Opis |
|---|---|
name |
Ime bloka (e.g., my-theme/my-block) |
title |
Naslov bloka |
dir |
Pot do mape bloka |
url |
URL mape bloka |
align |
Vrednost poravnave (če je omogočen supports.align) |
className |
Razred CSS po meri (če je omogočen supports.customClassName) |
anchor |
Sidro/ID HTML (če je omogočen supports.anchor) |
Podprte možnosti WordPress
Omogočite funkcije blokov WordPress prek lastnosti supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Za vse razpoložljive možnosti si oglejte WordPressdokumentacijo o podpori blokov.