Pāriet uz saturu

Bloku atribūti

Mainīgie $attributes vai $a nodrošina piekļuvi tikai datiem, kas reģistrēti rekvizītā blockstudio. Lai piekļūtu standarta WordPress bloka datiem, piemēram, līdzinājumam vai tipogrāfijai, izmantojiet mainīgos $block vai $b.

Renderēšana

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>

Noklusējuma vērtību iestatīšana

Rezervētie lauku ID

WordPress pārvaldītos atribūtus nedrīkst deklarēt kā Blockstudio laukus ar to pašu augstākā līmeņa ID. Rezervēti ir anchor, className, style, lock un metadata, kā arī Blockstudio iekšējie atribūti blockstudio, __BLOCKSTUDIO_KEY un blockEditingMode.

Arī iespējotie WordPress atbalsti rezervē savu atribūtu nosaukumus, ja tādi attiecas: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow un ariaLabel. Arī šo atribūtu sākotnējā deklarācija rezervē attiecīgo nosaukumu. Tas novērš, piemēram, kodola virknes align aizstāšanu ar atlasāmā lauka opciju objektu.

Konfliktējošie lauki reģistrēšanas laikā tiek izlaisti, un par tiem tiek ziņots, izmantojot blockstudio/error/logged (un WordPress atkļūdošanas žurnālu, ja tas ir iespējots), norādot bloku un lauku. To redaktora vadīklas, datu glabāšanas apstrādātāji un renderēšanas definīcijas netiek reģistrētas. Pārdēvējiet lauku par headingAlign vai ievietojiet to nosauktā grupā, piemēram, presentation, lai iegūtu presentation_align. Atkārtotāja rindas lauki atrodas rindas iekšpusē un nerada augstākā līmeņa konfliktus. Parasts align lauks joprojām ir derīgs, ja līdzināšanas atbalsts ir atspējots un nepastāv sākotnējs align atribūts.

Jauninot esošu bloku, kurā ir sadursme, pārdēvējiet tā lauku un migrējiet visas saglabātās lauka vērtības uz jauno ID. Blockstudio klusi nepārdēvē saglabāto saturu un nenoņem WordPress atbalstu.

Vietējās atribūtu noklusējuma vērtības

Lai iestatītu noklusējuma vērtību rekvizītiem WordPress, piemēram, align, pievienojiet atslēgu default atslēgā 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
}

Pieejamie bloka dati

Mainīgais $block / $b satur:

Rekvizīts Apraksts
name Bloka nosaukums (e.g., my-theme/my-block)
title Bloka virsraksts
dir Bloka mapes ceļš
url Bloka mapes URL
align Līdzinājuma vērtība (ja iespējots supports.align)
className Pielāgota CSS klase (ja iespējots supports.customClassName)
anchor HTML enkurs/ID (ja iespējots supports.anchor)

WordPress atbalsts

Iespējojiet bloka WordPress funkcijas, izmantojot rekvizītu 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 pieejamās opcijas skatiet WordPress bloku atbalsta dokumentācijā.