Атрибути на блокове
Променливите $attributes или $a дават достъп само до данните, регистрирани в свойството blockstudio. За достъп до стандартни данни на блокове WordPress, като подравняване или типография, използвайте променливите $block или $b.
Визуализиране
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>
Задаване на стойности по подразбиране
Запазени идентификатори на полета
Атрибути, управлявани от WordPress, не трябва да се декларират като полета Blockstudio със същия идентификатор от най-високо ниво. Запазени са anchor, className, style, lock и metadata, както и вътрешните атрибути на Blockstudio: blockstudio, __BLOCKSTUDIO_KEY и blockEditingMode.
Поддръжката на активирани WordPress също запазва имената на атрибутите им: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow и ariaLabel, когато е приложимо. Естествена декларация на някой от тези атрибути също запазва това име. Така например низовият align на ядрото няма да бъде заменен с обект с опции от поле за избор.
Конфликтните полета се пропускат при регистрация и се записват в дневника чрез blockstudio/error/logged (както и в дневника за отстраняване на грешки на WordPress, когато е активиран), като се посочват блокът и полето. Контролите им в редактора, манипулаторите за съхранение и дефинициите за визуализиране не се регистрират. Преименувайте полето на headingAlign или го поставете в именувана група, например presentation, за да получите presentation_align. Полетата на редовете на повторителите се намират в съответния ред и не са конфликти от най-високо ниво. Обикновено поле align остава валидно, когато поддръжката за подравняване е изключена и няма естествен атрибут align.
Когато надграждате съществуващ блок с колизия, преименувайте полето му и мигрирайте всички запазени стойности на полето към новия ID. Blockstudio не преименува мълчаливо съхраненото съдържание и не премахва поддръжката на WordPress.
Вградени стойности по подразбиране за атрибути
За да зададете стойност по подразбиране за свойства WordPress като align, добавете ключ default в ключа 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
}
Налични данни за блока
Променливата $block / $b съдържа:
| Свойство | Описание |
|---|---|
name |
Име на блока (e.g, my-theme/my-block) |
title |
Заглавие на блока |
dir |
Път до директорията на блока |
url |
URL на директорията на блока |
align |
Стойност на подравняването (ако supports.align е активирано) |
className |
Персонализиран клас CSS (ако supports.customClassName е активирано) |
anchor |
Котва/ID HTML (ако supports.anchor е активирано) |
Поддържани WordPress
Активирайте функциите на блоковете WordPress чрез свойството supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Вижте документацията за поддръжките на блокове WordPress за всички налични опции.