Hoppa till innehåll

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

PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>

Twig

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:

JSON
{
  "$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:

JSON
{
  "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.