Ga naar de inhoud

Blokattributen

Met de variabelen $attributes of $a krijg je alleen toegang tot gegevens die zijn geregistreerd in de eigenschap blockstudio. Gebruik de variabelen $block of $b om toegang te krijgen tot standaardblokgegevens van WordPress, zoals uitlijning of typografie.

Renderen

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>

Standaardwaarden instellen

Gereserveerde veld-ID’s

Door WordPress beheerde kenmerken mogen niet worden gedeclareerd als Blockstudio-velden met dezelfde ID op het hoogste niveau. anchor, className, style, lock en metadata zijn gereserveerd, evenals de interne kenmerken blockstudio, __BLOCKSTUDIO_KEY en blockEditingMode van Blockstudio.

Ingeschakelde ondersteuning voor WordPress reserveert ook de bijbehorende kenmerknamen: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow en ariaLabel, waar van toepassing. Een native declaratie van een van die kenmerken reserveert die naam ook. Zo wordt bijvoorbeeld voorkomen dat de string align van core wordt vervangen door het optieobject van een keuzelijstveld.

Conflicterende velden worden bij registratie overgeslagen en via blockstudio/error/logged geregistreerd (en via het debuglogboek WordPress wanneer dat is ingeschakeld), met vermelding van het blok en het veld. De bijbehorende editorbedieningselementen, opslaghandlers en renderdefinities worden niet geregistreerd. Wijzig de naam van het veld in headingAlign, of plaats het in een benoemde groep zoals presentation om presentation_align te maken. Velden van repeater-rijen staan in hun rij en veroorzaken geen conflicten op het hoogste niveau. Een gewoon align-veld blijft geldig wanneer ondersteuning voor uitlijning is uitgeschakeld en er geen native kenmerk align bestaat.

Wanneer u een bestaand blok met een conflict bijwerkt, hernoemt u het veld en migreert u alle opgeslagen veldwaarden naar de nieuwe ID. Blockstudio hernoemt opgeslagen inhoud niet stilzwijgend en verwijdert de ondersteuning voor WordPress niet.

Standaardwaarden voor native attributen

Als je een standaardwaarde wilt instellen voor eigenschappen van WordPress, zoals align, voeg je een sleutel default toe binnen de sleutel 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
}

Beschikbare blokgegevens

De variabele $block / $b bevat:

Eigenschap Beschrijving
name Bloknaam (e.g, my-theme/my-block)
title Bloktitel
dir Pad naar blokmap
url URL van blokmap
align Uitlijningswaarde (als supports.align is ingeschakeld)
className Aangepaste klasse CSS (als supports.customClassName is ingeschakeld)
anchor HTML-anker/ID (als supports.anchor is ingeschakeld)

Ondersteunde functies van WordPress

Schakel blokfuncties van WordPress in via de eigenschap supports:

JSON
{
  "supports": {
    "align": true,
    "anchor": true,
    "customClassName": true,
    "color": {
      "background": true,
      "text": true
    },
    "spacing": {
      "margin": true,
      "padding": true
    },
    "typography": {
      "fontSize": true,
      "lineHeight": true
    }
  }
}

Raadpleeg de documentatie over WordPress-blokondersteuning voor alle beschikbare opties.