Přejít k obsahu

Atributy bloku

Proměnné $attributes nebo $a umožňují přístup pouze k datům zaregistrovaným ve vlastnosti blockstudio. Ke standardním datům bloku WordPress, jako je zarovnání nebo typografie, získáte přístup pomocí proměnných $block nebo $b.

Vykreslování

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>

Nastavení výchozích hodnot

Rezervovaná ID polí

Atributy spravované WordPress se nesmějí deklarovat jako pole Blockstudio se stejným ID nejvyšší úrovně. Rezervované jsou položky anchor, className, style, lock a metadata, stejně jako interní atributy blockstudio, __BLOCKSTUDIO_KEY a blockEditingMode v rámci Blockstudio.

Povolené podpory WordPress si také rezervují názvy svých atributů: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow a ariaLabel, podle toho, které jsou použity. Stejný název rezervuje i nativní deklarace jednoho z těchto atributů. Tím se například zabrání nahrazení řetězce align z jádra objektem s možnostmi výběrového pole.

Konfliktní pole se při registraci přeskočí a zaznamenají prostřednictvím blockstudio/error/logged (a při zapnutí ladicího protokolu WordPress), přičemž se uvede název bloku a pole. Neregistrují se jejich ovládací prvky editoru, obslužné rutiny úložiště ani definice vykreslení. Přejmenujte pole na headingAlign nebo je vložte do pojmenované skupiny, například presentation, čímž vznikne presentation_align. Pole opakovače žijí uvnitř svého řádku, a proto nejsou kolizemi na nejvyšší úrovni. Běžné pole align zůstává platné, když je podpora zarovnání vypnutá a neexistuje žádný nativní atribut align.

Při upgradu existujícího bloku s kolizí přejmenujte jeho pole a přesuňte všechny uložené hodnoty pole na nové ID. Blockstudio potichu nepřejmenovává uložený obsah ani neodebírá podporu WordPress.

Výchozí hodnoty nativních atributů

Chcete-li nastavit výchozí hodnotu pro vlastnosti WordPress, například align, přidejte klíč default do klíče 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
}

Dostupná data bloku

Proměnná $block / $b obsahuje:

Vlastnost Popis
name Název bloku (e.g, my-theme/my-block)
title Název bloku
dir Cesta k adresáři bloku
url URL adresáře bloku
align Hodnota zarovnání (pokud je povoleno supports.align)
className Vlastní třída CSS (pokud je povoleno supports.customClassName)
anchor Kotva/ID HTML (pokud je povoleno supports.anchor)

Podpora WordPress

Zapněte funkce bloků WordPress prostřednictvím vlastnosti supports:

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

Všechny dostupné možnosti najdete v dokumentaci podpory bloků WordPress Block Supports.