Treci la conținut

Atributele blocului

Variabilele $attributes sau $a vă oferă acces doar la datele înregistrate în proprietatea blockstudio. Pentru a accesa datele standard ale blocurilor WordPress, precum alinierea sau tipografia, folosiți variabilele $block sau $b.

Redare

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>

Setarea valorilor implicite

ID-uri de câmp rezervate

Atributele gestionate de WordPress nu trebuie declarate drept câmpuri Blockstudio cu același ID de nivel superior. anchor, className, style, lock și metadata sunt rezervate, la fel ca atributele interne blockstudio, __BLOCKSTUDIO_KEY ale Blockstudio și atributul blockEditingMode.

Suporturile WordPress activate își rezervă și ele numele atributelor: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow și ariaLabel, după caz. O declarație nativă a unuia dintre aceste atribute îi rezervă, de asemenea, numele. Astfel se evită înlocuirea, de exemplu, a valorii string align din core cu obiectul de opțiuni al unui câmp de tip select.

Câmpurile aflate în conflict sunt omise la înregistrare și raportate prin blockstudio/error/logged (precum și în jurnalul de depanare WordPress, dacă este activat), cu indicarea blocului și a câmpului. Controalele din editor, gestionarele de stocare și definițiile de randare aferente nu sunt înregistrate. Redenumiți câmpul în headingAlign sau plasați-l într-un grup cu nume, cum ar fi presentation, pentru a obține presentation_align. Câmpurile din rândurile repetorului se află în interiorul rândului și nu intră în conflict cu câmpurile de nivel superior. Un câmp align obișnuit rămâne valid când suportul pentru aliniere este dezactivat și nu există niciun atribut nativ align.

Când actualizați un bloc existent cu o coliziune, redenumiți câmpul și migrați valorile salvate ale câmpului la noul ID. Blockstudio nu redenumește în mod silențios conținutul stocat și nu elimină suportul pentru WordPress.

Valori native implicite ale atributelor

Pentru a seta o valoare implicită pentru proprietăți WordPress precum align, adăugați o cheie default în interiorul cheii 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
}

Datele disponibile ale blocului

Variabila $block / $b conține:

Proprietate Descriere
name Numele blocului (e.g., my-theme/my-block)
title Titlul blocului
dir Calea către directorul blocului
url URL directorului blocului
align Valoarea alinierii (dacă supports.align este activat)
className Clasa CSS personalizată (dacă supports.customClassName este activat)
anchor Ancoră/ID HTML (dacă supports.anchor este activat)

Suporturi WordPress

Activați funcționalitățile blocului WordPress prin proprietatea supports:

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

Consultați documentația WordPress Block Supports pentru toate opțiunile disponibile.