Liigu sisu juurde

Ploki atribuudid

Muutujad $attributes või $a annavad juurdepääsu ainult andmetele, mis on registreeritud atribuudi blockstudio all. Standardsetele WordPress plokiandmetele, näiteks joondusele või tüpograafiale, juurdepääsemiseks kasutage muutujaid $block või $b.

Renderdamine

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>

Vaikeväärtuste määramine

Reserveeritud välja-ID-d

WordPress hallatavaid atribuute ei tohi määrata Blockstudio väljadena sama ülataseme ID-ga. Reserveeritud on anchor, className, style, lock ja metadata, samuti Blockstudio sisemised atribuudid blockstudio, __BLOCKSTUDIO_KEY ja blockEditingMode.

Lubatud WordPress tugi reserveerib vajaduse korral ka nende atribuutide nimed: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow ja ariaLabel. Nime reserveerib ka mõne sellise atribuudi natiivne deklaratsioon. Nii välditakse näiteks core’i tekstilise align asendamist valikuvälja valikute objektiga.

Vastuolulised väljad jäetakse registreerimisel vahele ja neist antakse teada logi kaudu blockstudio/error/logged (ning lubatud WordPress silumislogis), kus nimetatakse plokk ja väli. Nende redaktori juhtelemente, salvestuskäitlureid ega renderdusmääratlusi ei registreerita. Nimetage väli ümber kujule headingAlign või paigutage see nimetatud rühma, näiteks presentation, et saada presentation_align. Kordaja rea väljad asuvad oma reas ega põhjusta ülataseme konflikte. Tavaline align väli kehtib ka siis, kui joondustugi on keelatud ja natiivset atribuuti align pole.

Uuendades olemasolevat plokki, milles tekib konflikt, nimetage selle väli ümber ja viige kõik salvestatud välja väärtused üle uuele ID-le. Blockstudio ei nimeta salvestatud sisu vaikselt ümber ega eemalda WordPress tuge.

Natiivsed atribuudi vaikeväärtused

Atribuutide WordPress vaikeväärtuse (nt align) määramiseks lisage võtme attributes sisse võti default:

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
}

Saadaolevad plokiandmed

Muutuja $block / $b sisaldab järgmist:

Atribuut Kirjeldus
name Ploki nimi (e.g, my-theme/my-block)
title Ploki pealkiri
dir Ploki kataloogi tee
url Ploki kataloogi URL
align Joondusväärtus (kui supports.align on lubatud)
className Kohandatud CSS-klass (kui supports.customClassName on lubatud)
anchor HTML ankur/ID (kui supports.anchor on lubatud)

WordPress tugi

Lubage ploki WordPress funktsioonid atribuudi supports kaudu:

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

Kõigi saadaolevate valikute kohta leiate teavet dokumentatsioonist WordPress Block Supports.