Preskoči na vsebino

Atributi blokov

Spremenljivki $attributes ali $a omogočata dostop samo do podatkov, registriranih v lastnosti blockstudio. Za dostop do standardnih podatkov bloka WordPress, kot sta poravnava ali tipografija, uporabite spremenljivki $block ali $b.

Izrisovanje

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>

Nastavitev privzetih vrednosti

Rezervirani ID-ji polj

Atributi, ki jih upravlja WordPress, ne smejo biti deklarirani kot polja Blockstudio z enakim ID-jem na najvišji ravni. Rezervirani so anchor, className, style, lock in metadata, prav tako pa tudi notranji atributi blockstudio, __BLOCKSTUDIO_KEY in blockEditingMode v Blockstudio.

Omogočena podpora WordPress prav tako rezervira ustrezna imena atributov: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow in ariaLabel, kadar je to ustrezno. Tudi izvorna deklaracija enega od teh atributov rezervira njegovo ime. Tako se na primer nizovni atribut align jedra ne zamenja z objektom možnosti izbirnega polja.

Nasprotujoča se polja so pri registraciji preskočena, o njih pa se zabeleži sporočilo prek blockstudio/error/logged (in dnevnika za razhroščevanje WordPress, kadar je ta omogočen); navedena sta blok in polje. Njihovi kontrolniki urejevalnika, upravljalniki shranjevanja in definicije izrisa niso registrirani. Preimenujte polje v headingAlign ali ga postavite v poimenovano skupino, kot je presentation, da dobite presentation_align. Polja vrstic ponavljalnika so znotraj svoje vrstice in ne povzročajo konfliktov na najvišji ravni. Običajno polje align ostane veljavno, kadar je podpora za poravnavo onemogočena in izvorni atribut align ne obstaja.

Pri nadgradnji obstoječega bloka s kolizijo preimenujte njegovo polje in preselite vse shranjene vrednosti polja na novi ID. Blockstudio shranjene vsebine ne preimenuje samodejno in ne odstrani podpore za WordPress.

Privzete vrednosti izvornih atributov

Če želite nastaviti privzeto vrednost za lastnosti WordPress, kot je align, dodajte ključ default znotraj ključ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
}

Razpoložljivi podatki bloka

Spremenljivka $block / $b vsebuje:

Lastnost Opis
name Ime bloka (e.g., my-theme/my-block)
title Naslov bloka
dir Pot do mape bloka
url URL mape bloka
align Vrednost poravnave (če je omogočen supports.align)
className Razred CSS po meri (če je omogočen supports.customClassName)
anchor Sidro/ID HTML (če je omogočen supports.anchor)

Podprte možnosti WordPress

Omogočite funkcije blokov WordPress prek lastnosti supports:

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

Za vse razpoložljive možnosti si oglejte WordPressdokumentacijo o podpori blokov.