Gå til indhold

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

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>

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:

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
}

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:

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-blokunderstøttelse for alle tilgængelige muligheder.