Blockattribut
Variablerna $attributes eller $a ger endast åtkomst till data som registrerats i egenskapen blockstudio. Använd variablerna $block eller $b för att komma åt standarddata för WordPress-block, till exempel justering och typografi.
Rendering
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>
Ange standardvärden
Reserverade fält-ID:n
Attribut som ägs av WordPress får inte deklareras som Blockstudio-fält med samma ID på toppnivå. anchor, className, style, lock och metadata är reserverade, liksom Blockstudios interna attribut blockstudio, __BLOCKSTUDIO_KEY och blockEditingMode.
Aktiverade WordPress-stöd reserverar också sina attributnamn: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow och ariaLabel, i förekommande fall. En inbyggd deklaration av något av dessa attribut reserverar också namnet. Därmed undviks till exempel att ersätta kärnans sträng align med ett alternativobjekt från ett select-fält.
Motstridiga fält hoppas över vid registreringen och loggas via blockstudio/error/logged (och i felsökningsloggen WordPress när den är aktiverad), med block och fält angivna. Deras redigerarkontroller, lagringshanterare och renderingsdefinitioner registreras inte. Byt namn på fältet till headingAlign eller placera det i en namngiven grupp, till exempel presentation, för att skapa presentation_align. Fält i uppreparrader ligger inuti sin rad och orsakar inte kollisioner på toppnivå. Ett vanligt align-fält är fortfarande giltigt när justeringsstöd är inaktiverat och inget inbyggt align-attribut finns.
När du uppgraderar ett befintligt block med en kollision byter du namn på fältet och migrerar eventuella sparade fältvärden till det nya ID:t. Blockstudio byter inte namn på lagrat innehåll i tysthet och tar inte bort stödet för WordPress.
Inbyggda attributstandardvärden
Ange ett standardvärde för egenskaper i WordPress, till exempel align, genom att lägga till nyckeln default i nyckeln 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
}
Tillgängliga blockdata
Variabeln $block / $b innehåller:
| Egenskap | Beskrivning |
|---|---|
name |
Blocknamn (e.g., my-theme/my-block) |
title |
Blocktitel |
dir |
Sökväg till blockkatalogen |
url |
Blockkatalogens URL |
align |
Justeringsvärde (om supports.align är aktiverat) |
className |
Anpassad CSS-klass (om supports.customClassName är aktiverat) |
anchor |
HTML-ankare/ID (om supports.anchor är aktiverat) |
Stöd för WordPress
Aktivera blockfunktioner för WordPress via egenskapen 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 blockstöd för alla tillgängliga alternativ.