Siirry sisältöön

Lohkoattribuutit

$attributes– tai $a-muuttujilla pääset käsiksi vain blockstudio-ominaisuuteen rekisteröityihin tietoihin. Voit käyttää tavallisia WordPress-lohkon tietoja, kuten kohdistusta tai typografiaa, $block– tai $b-muuttujilla.

Renderöinti

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>

Oletusarvojen asettaminen

Varatut kenttätunnukset

WordPress-omistamia attribuutteja ei saa määrittää Blockstudio-kentiksi samalla ylätason tunnuksella. Varattuja ovat anchor, className, style, lock ja metadata, samoin kuin Blockstudio-sisäiset attribuutit blockstudio, __BLOCKSTUDIO_KEY ja blockEditingMode.

Käytössä olevat WordPress-laajennukset varaavat myös omien attribuuttiensa nimet tarpeen mukaan: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow ja ariaLabel. Myös jonkin näistä attribuuteista natiivi määrittely varaa kyseisen nimen. Näin estetään esimerkiksi ytimen merkkijonon align korvaaminen valintakentän asetusoliolla.

Ristiriitaiset kentät ohitetaan rekisteröinnissä ja niistä kirjataan lokimerkintä kohteeseen blockstudio/error/logged (sekä virheenjäljityslokiin WordPress, jos se on käytössä). Merkinnässä mainitaan lohko ja kenttä. Niiden editorisäätimiä, tallennuskäsittelijöitä ja renderöintimäärityksiä ei rekisteröidä. Nimeä kenttä uudelleen tunnukseksi headingAlign tai sijoita se nimettyyn ryhmään, kuten presentation, jolloin tulokseksi tulee presentation_align. Toistinkentät sijaitsevat rivinsä sisällä eivätkä aiheuta ylätason tunnusristiriitoja. Tavallinen align-kenttä on kelvollinen, kun tasaustuki on poistettu käytöstä eikä natiivia align-attribuuttia ole.

Kun päivität olemassa olevaa lohkoa, jossa on ristiriita, nimeä sen kenttä uudelleen ja siirrä kaikki tallennetut kenttäarvot uuteen tunnukseen. Blockstudio ei nimeä tallennettua sisältöä uudelleen eikä poista WordPress-tukea hiljaisesti.

Natiivien attribuuttien oletusarvot

Aseta oletusarvo WordPress-ominaisuuksille, kuten align, lisäämällä default-avain attributes-avaimen sisään:

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
}

Käytettävissä olevat lohkotiedot

$block / $b-muuttuja sisältää:

Ominaisuus Kuvaus
name Lohkon nimi (e.g., my-theme/my-block)
title Lohkon otsikko
dir Lohkon hakemistopolku
url Lohkon hakemiston URL
align Kohdistusarvo (jos supports.align on käytössä)
className Mukautettu CSS-luokka (jos supports.customClassName on käytössä)
anchor HTML-ankkuri/tunnus (jos supports.anchor on käytössä)

WordPress-tuet

Ota WordPress-lohko-ominaisuudet käyttöön supports-ominaisuuden kautta:

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

Katso WordPress-lohkojen tukien dokumentaatiosta kaikki käytettävissä olevat vaihtoehdot.