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
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
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:
{
"$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:
{
"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ā.