Ugrás a tartalomhoz

Blokkattribútumok

A $attributes vagy $a változóval csak a blockstudio tulajdonságban regisztrált adatok érhetők el. Az igazításhoz vagy tipográfiához hasonló szabványos WordPress blokkadatok eléréséhez használja a $block vagy a $b változót.

Renderelés

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>

Alapértelmezett értékek beállítása

Fenntartott mezőazonosítók

A WordPress által kezelt attribútumokat nem szabad ugyanazzal a legfelső szintű azonosítóval rendelkező Blockstudio mezőként deklarálni. A anchor, className, style, lock és metadata, valamint a Blockstudio belső blockstudio, __BLOCKSTUDIO_KEY és blockEditingMode attribútumai fenntartottak.

Az engedélyezett WordPress támogatások attribútumnevei szintén fenntartottak: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow és ariaLabel, ha alkalmazhatók. Ezen attribútumok natív deklarációja szintén fenntartja az adott nevet. Így például a core szöveges align attribútumát nem írja felül egy választómező opcióobjektuma.

Az ütköző mezőket a rendszer kihagyja a regisztrációkor, és a blockstudio/error/logged segítségével naplózza (ha engedélyezve van, a WordPress hibakeresési naplóba is), megnevezve a blokkot és a mezőt. A mező szerkesztővezérlői, tárolókezelői és megjelenítési definíciói nem kerülnek regisztrálásra. Nevezze át a mezőt erre: headingAlign, vagy helyezze el egy névvel ellátott csoportban, például presentation, így a létrejövő érték: presentation_align. Az ismétlő sorainak mezői a soron belül találhatók, ezért nem okoznak legfelső szintű ütközést. Egy szokásos align mező akkor is érvényes marad, ha az igazítás támogatása ki van kapcsolva, és nincs natív align attribútum.

Ha ütközést okozó meglévő blokkot frissít, nevezze át a mezőjét, és migrálja az összes mentett mezőértéket az új azonosítóra. A Blockstudio nem nevezi át észrevétlenül a tárolt tartalmat, és nem távolítja el a WordPress támogatását.

Natív attribútumalapértelmezések

Az olyan WordPress tulajdonságok alapértelmezett értékének megadásához, mint a align, adjon meg egy default kulcsot a attributes kulcson belül:

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
}

Elérhető blokkadatok

A $block / $b változó a következőket tartalmazza:

Tulajdonság Leírás
name Blokknév (e.g, my-theme/my-block)
title Blokk címe
dir A blokk könyvtárának elérési útja
url A blokk könyvtárának URL értéke
align Igazítási érték (ha a supports.align engedélyezve van)
className Egyéni CSS osztály (ha a supports.customClassName engedélyezve van)
anchor HTML horgony/azonosító (ha a supports.anchor engedélyezve van)

WordPress támogatása

Engedélyezze a WordPress blokkfunkciókat a supports tulajdonságon keresztül:

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

Az elérhető beállításokért tekintse meg a WordPress blokkfunkciók dokumentációját.