Blokattributter
Variablerne $attributes eller $a giver kun adgang til data, der er registreret i egenskaben blockstudio. Brug variablerne $block eller $b for at få adgang til standarddata for WordPress-blokke, f.eks. justering eller typografi.
Gengivelse
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>
Angivelse af standardværdier
Reserverede felt-id’er
Attributter, der ejes af WordPress, må ikke deklareres som Blockstudio-felter med samme id på øverste niveau. anchor, className, style, lock og metadata er reserveret, ligesom Blockstudios interne attributter blockstudio og __BLOCKSTUDIO_KEY samt blockEditingMode.
Aktiverede WordPress-understøttelser reserverer også deres attributnavne: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow og ariaLabel, alt efter hvad der er relevant. En indbygget deklaration af en af disse attributter reserverer også navnet. Det forhindrer for eksempel, at cores streng-align erstattes af et select-felts optionsobjekt.
Modstridende felter springes over ved registreringen og logges via blockstudio/error/logged (og debugloggen WordPress, hvis den er aktiveret), med angivelse af blok og felt. Deres editorstyringer, lagerhåndteringer og renderdefinitioner registreres ikke. Omdøb feltet til headingAlign, eller placér det i en navngiven gruppe som presentation for at oprette presentation_align. Felter i repeater-rækker ligger i deres række og er ikke sammenstød på øverste niveau. Et almindeligt align-felt er stadig gyldigt, når justeringsunderstøttelse er deaktiveret, og der ikke findes nogen indbygget attribut align.
Når du opgraderer en eksisterende blok med en konflikt, skal du omdøbe feltet og migrere eventuelle gemte feltværdier til det nye ID. Blockstudio omdøber ikke gemt indhold automatisk eller fjerner understøttelsen af WordPress.
Standardværdier for oprindelige attributter
Hvis du vil angive en standardværdi for egenskaber i WordPress, f.eks. align, skal du tilføje en nøgle default inde i nøglen 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
}
Tilgængelige blokdata
Variablen $block / $b indeholder:
| Egenskab | Beskrivelse |
|---|---|
name |
Bloknavn (e.g., my-theme/my-block) |
title |
Bloktitel |
dir |
Sti til blokmappe |
url |
Blokmappens URL |
align |
Justeringsværdi (hvis supports.align er aktiveret) |
className |
Brugerdefineret CSS-klasse (hvis supports.customClassName er aktiveret) |
anchor |
HTML-anker/ID (hvis supports.anchor er aktiveret) |
Understøttelse af WordPress
Aktivér blokfunktioner i WordPress via egenskaben supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Se dokumentationen om WordPress-blokunderstøttelse for alle tilgængelige muligheder.