Preskočiť na obsah

Atribúty bloku

Premenné $attributes alebo $a umožňujú prístup iba k údajom zaregistrovaným vo vlastnosti blockstudio. Ak chcete získať prístup k štandardným údajom bloku WordPress, ako je zarovnanie alebo typografia, použite premenné $block alebo $b.

Vykresľovanie

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>

Nastavenie predvolených hodnôt

Vyhradené ID polí

Atribúty spravované cez WordPress sa nesmú deklarovať ako polia Blockstudio s rovnakým ID najvyššej úrovne. Vyhradené sú anchor, className, style, lock a metadata, rovnako ako interné atribúty blockstudio, __BLOCKSTUDIO_KEY a blockEditingMode spravované cez Blockstudio.

Aj funkcie WordPress, ktoré sú zapnuté, si vyhradzujú názvy svojich atribútov: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow a ariaLabel podľa potreby. Aj natívna deklarácia niektorého z týchto atribútov rezervuje jeho názov. Tým sa predíde napríklad nahradeniu textovej hodnoty align jadra objektom s možnosťami výberového poľa.

Konfliktné polia sa pri registrácii preskočia a zaznamenajú cez blockstudio/error/logged (a pri zapnutom ladení aj do diagnostického záznamu WordPress), pričom sa uvedie názov bloku a poľa. Ich ovládacie prvky editora, obslužné rutiny úložiska a definície vykreslenia sa nezaregistrujú. Premenujte pole na headingAlign alebo ho vložte do pomenovanej skupiny, napríklad presentation, aby vzniklo presentation_align. Polia riadkov opakovača sú v rámci svojho riadka, a preto nekolidujú s poľami najvyššej úrovne. Bežné pole align zostáva platné, keď je podpora zarovnania vypnutá a neexistuje natívny atribút align.

Pri aktualizácii existujúceho bloku s kolíziou premenujte jeho pole a preneste všetky uložené hodnoty poľa na nové ID. Blockstudio potichu nepremenuje uložený obsah ani neodstráni podporu WordPress.

Predvolené hodnoty natívnych atribútov

Ak chcete nastaviť predvolenú hodnotu vlastností WordPress, napríklad align, pridajte kľúč default do kľúča 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é údaje bloku

Premenná $block / $b obsahuje:

Vlastnosť Opis
name Názov bloku (e.g., my-theme/my-block)
title Názov bloku
dir Cesta k priečinku bloku
url URL priečinka bloku
align Hodnota zarovnania (ak je zapnutá možnosť supports.align)
className Vlastná trieda CSS (ak je zapnutá možnosť supports.customClassName)
anchor Kotva/ID HTML (ak je zapnutá možnosť supports.anchor)

Podporované funkcie WordPress

Zapnite funkcie bloku WordPress pomocou 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šetky dostupné možnosti nájdete v dokumentácii o podpore blokov BlockWordPress.