Pereiti prie turinio

Bloko atributai

Kintamieji $attributes ir $a suteikia prieigą tik prie duomenų, užregistruotų savybėje blockstudio. Norėdami pasiekti standartinius WordPress bloko duomenis, pavyzdžiui, lygiavimą ar tipografiją, naudokite kintamuosius $block arba $b.

Atvaizdavimas

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>

Numatytojo nustatymas

Rezervuoti laukų ID

WordPress valdomi atributai neturi būti deklaruojami kaip Blockstudio laukai su tuo pačiu aukščiausio lygio ID. Rezervuoti yra anchor, className, style, lock ir metadata, taip pat Blockstudio vidiniai blockstudio, __BLOCKSTUDIO_KEY ir blockEditingMode atributai.

Įjungti WordPress taip pat rezervuoja atitinkamus savo atributų pavadinimus: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow ir ariaLabel. Gimtasis deklaravimas taip pat rezervuoja tų atributų pavadinimus. Taip, pavyzdžiui, išvengiama situacijos, kai šerdies eilutė align pakeičiama pasirinkimo lauko parinkčių objektu.

Konfliktuojantys laukai praleidžiami registruojant, o apie juos pranešama per blockstudio/error/logged (ir, jei įjungtas, derinimo žurnalas WordPress), nurodant bloką ir lauką. Jų redaktoriaus valdikliai, saugojimo apdorojimo priemonės ir atvaizdavimo apibrėžtys neregistruojamos. Pervadinkite lauką į headingAlign arba įdėkite jį į pavadintą grupę, pavyzdžiui, presentation, kad gautumėte presentation_align. Kartotuvo eilutės laukai yra eilutės viduje ir nesukelia aukščiausio lygio konfliktų. Įprastas align laukas lieka tinkamas, kai lygiavimo palaikymas išjungtas ir nėra gimtojo atributo align.

Atnaujinant esamą bloką, kurio laukas konfliktuoja, pervadinkite jo lauką ir perkelkite visas išsaugotas lauko reikšmes į naują ID. Blockstudio tyliai nepervadina išsaugoto turinio ir nepašalina WordPress palaikymo.

Natyviosios atributų numatytosios reikšmės

Norėdami nustatyti numatytąją WordPress savybių, pavyzdžiui, align, reikšmę, pridėkite raktą default rakto attributes viduje:

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
}

Galimi bloko duomenys

Kintamajame $block / $b yra:

Savybė Aprašymas
name Bloko pavadinimas (e.g., my-theme/my-block)
title Bloko pavadinimas sąsajoje
dir Bloko katalogo kelias
url Bloko katalogo URL
align Lygiavimo reikšmė (jei įjungta supports.align)
className Pasirinktinė CSS klasė (jei įjungta supports.customClassName)
anchor HTML inkaras / ID (jei įjungta supports.anchor)

WordPress palaikymas

Įjunkite WordPress bloko funkcijas naudodami savybę supports:

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

Visas galimas parinktis rasite WordPressBlokų palaikymo dokumentacijoje.