Збірник шаблонів полів
Система полів Blockstudio проста сама по собі: додайте поле до blockstudio.attributes, а у шаблоні зверніться до нього через $a. Але в реальних блоках рідко буває лише одне поле. Зазвичай вони містять групи пов’язаних налаштувань, поля, що з’являються або зникають залежно від інших полів, повторювачі зі складною структурою рядків, а також дані, до яких потрібно мати доступ для запитів поза редактором блоків.
У цьому посібнику зібрано практичні рецепти поширених шаблонів полів. Кожен рецепт містить конфігурацію block.json і відповідний код шаблону. Скопіюйте їх безпосередньо у свої блоки та за потреби адаптуйте.
Умовні поля
Найпоширеніший шаблон: показувати або приховувати поля залежно від значення іншого поля. Так редактор залишається впорядкованим і показує лише доречні параметри.
Перемикач для показу параметрів
Блок CTA, у якому додаткові налаштування з’являються, коли користувач вмикає кнопку:
{
"name": "my-theme/cta",
"title": "Call to Action",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Ready to get started?" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "showButton", "type": "toggle", "label": "Show Button", "default": true },
{
"id": "buttonText",
"type": "text",
"label": "Button Text",
"default": "Get Started",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
},
{
"id": "buttonUrl",
"type": "link",
"label": "Button Link",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
}
]
}
}
Поля тексту кнопки та посилання з’являються, лише коли перемикач увімкнено. У шаблоні перевірте стан перемикача перед відображенням:
<div useBlockProps>
<h2><?php echo esc_html( $a['heading'] ); ?></h2>
<?php if ( $a['description'] ) : ?>
<p><?php echo esc_html( $a['description'] ); ?></p>
<?php endif; ?>
<?php if ( $a['showButton'] && $a['buttonUrl'] ) : ?>
<a href="<?php echo esc_url( $a['buttonUrl']['url'] ); ?>">
<?php echo esc_html( $a['buttonText'] ); ?>
</a>
<?php endif; ?>
</div>
Список вибору для перемикання наборів полів
Блок hero, у якому тип тла визначає, які поля з’являються:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{
"id": "bgType",
"type": "select",
"label": "Background Type",
"default": "color",
"options": [
{ "value": "color", "label": "Solid Color" },
{ "value": "gradient", "label": "Gradient" },
{ "value": "image", "label": "Image" },
{ "value": "video", "label": "Video" }
]
},
{
"id": "bgColor",
"type": "color",
"label": "Background Color",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "color" }]]
},
{
"id": "bgGradient",
"type": "gradient",
"label": "Background Gradient",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "gradient" }]]
},
{
"id": "bgImage",
"type": "files",
"label": "Background Image",
"multiple": false,
"conditions": [[{ "id": "bgType", "operator": "==", "value": "image" }]]
},
{
"id": "bgVideo",
"type": "files",
"label": "Background Video",
"multiple": false,
"allowedTypes": ["video"],
"conditions": [[{ "id": "bgType", "operator": "==", "value": "video" }]]
},
{
"id": "overlay",
"type": "range",
"label": "Overlay Opacity",
"default": 50,
"min": 0,
"max": 100,
"conditions": [[{ "id": "bgType", "operator": "!=", "value": "color" }]]
}
]
}
}
Поле прозорості накладання використовує !=, щоб з’являтися для всіх варіантів, крім суцільного кольору. Одночасно відображається лише одне поле тла. Поле color повертає масив із value, name і slug кольору, тож у шаблоні використовується ['value']:
<?php
$bg_style = match ( $a['bgType'] ) {
'color' => $a['bgColor'] ? "background-color: {$a['bgColor']['value']}" : '',
'gradient' => $a['bgGradient'] ? "background: {$a['bgGradient']}" : '',
'image' => $a['bgImage'] ? "background-image: url({$a['bgImage']['url']})" : '',
default => '',
};
?>
<div useBlockProps style="<?php echo esc_attr( $bg_style ); ?>">
<?php if ( $a['bgType'] === 'video' && $a['bgVideo'] ) : ?>
<video autoplay muted loop playsinline>
<source src="<?php echo esc_url( $a['bgVideo']['url'] ); ?>" />
</video>
<?php endif; ?>
<h1><?php echo esc_html( $a['heading'] ); ?></h1>
</div>
Умови АБО
Показуйте поле, коли виконується будь-яка з кількох умов. Кожен внутрішній масив — це група умов І, а зовнішній масив поєднує їх оператором АБО:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Це показує поле підпису, коли bgType має значення “image” АБО “video”.
Послідовні умови
Кілька умов в одному внутрішньому масиві працюють за логікою І:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Поле альтернативного тексту з’являється, лише коли bgType має значення “image” І вибрано зображення.
Глобальні умови
Показуйте поля залежно від типу запису, ID запису або ролі користувача, а не значень інших полів:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Доступні типи глобальних умов: postType, postId, userRole, userId.
Упорядковані налаштування
У міру ускладнення блоків групування полів за логічними категоріями допомагає підтримувати зручність інспектора.
Групи для візуального впорядкування
Групи створюють в інспекторі розгортані секції. Група без назви (без id) суто візуальна; її поля доступні за звичайними ID:
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"attributes": [
{
"type": "group",
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "image", "type": "files", "label": "Image", "multiple": false }
]
},
{
"type": "group",
"title": "Link",
"attributes": [
{ "id": "url", "type": "link", "label": "URL" },
{ "id": "openInNewTab", "type": "toggle", "label": "Open in New Tab" }
]
},
{
"type": "group",
"title": "Appearance",
"attributes": [
{
"id": "style",
"type": "select",
"label": "Style",
"default": "elevated",
"options": [
{ "value": "elevated", "label": "Elevated" },
{ "value": "outlined", "label": "Outlined" },
{ "value": "flat", "label": "Flat" }
]
},
{ "id": "accentColor", "type": "color", "label": "Accent Color" }
]
}
]
}
}
<div useBlockProps>
<h3><?php echo esc_html( $a['title'] ); ?></h3>
<p><?php echo esc_html( $a['description'] ); ?></p>
</div>
Поля доступні безпосередньо: $a['title'], $a['style'], $a['accentColor']. Групи впливають лише на розташування елементів в інспекторі.
Іменовані групи з bs_get_group
Якщо група має id, до ID її дочірніх полів додається префікс. Щоб прибрати його, використовуйте bs_get_group():
{
"id": "author",
"type": "group",
"title": "Author",
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "avatar", "type": "files", "label": "Avatar", "multiple": false }
]
}
Без допоміжної функції доступ до полів такий: $a['author_name'], $a['author_role'], $a['author_avatar']. З нею:
<?php $author = bs_get_group( $a, 'author' ); ?>
<div class="author">
<?php if ( $author['avatar'] ) : ?>
<img src="<?php echo esc_url( $author['avatar']['url'] ); ?>" alt="" />
<?php endif; ?>
<p><?php echo esc_html( $author['name'] ); ?></p>
<p><?php echo esc_html( $author['role'] ); ?></p>
</div>
Іменовані групи корисні, коли ті самі назви полів з’являються у кількох групах (e.g, author_name і company_name), або коли групу потрібно передати цілком у частковий шаблон.
Сітковий макет груп
Використовуйте властивість style, щоб розташувати дочірні елементи групи поруч:
{
"type": "group",
"title": "Dimensions",
"style": {
"display": "grid",
"grid-template-columns": "1fr 1fr",
"grid-gap": "16px"
},
"attributes": [
{ "id": "width", "type": "unit", "label": "Width", "default": "100%", "switch": false },
{ "id": "height", "type": "unit", "label": "Height", "default": "auto", "switch": false }
]
}
Два поля одиниць відображаються в інспекторі поруч, а не одне під одним. Це зручно для пар розмірів, значень відступів або будь-яких двох концептуально пов’язаних полів.
Вкладки для основних розділів
Якщо блок має багато налаштувань, вкладки забезпечують зручніше впорядкування, ніж довгий список груп:
{
"type": "tabs",
"tabs": [
{
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "body", "type": "wysiwyg", "label": "Body" }
]
},
{
"title": "Media",
"attributes": [
{ "id": "image", "type": "files", "label": "Image", "multiple": false },
{ "id": "video", "type": "files", "label": "Video", "multiple": false, "allowedTypes": ["video"] }
]
},
{
"title": "Settings",
"attributes": [
{ "id": "layout", "type": "select", "label": "Layout", "options": [
{ "value": "left", "label": "Media Left" },
{ "value": "right", "label": "Media Right" }
]},
{ "id": "fullWidth", "type": "toggle", "label": "Full Width" }
]
}
]
}
До полів кожної вкладки можна звертатися як до полів верхнього рівня: $a['title'], $a['image'], $a['layout']. Вкладки — це лише контейнер UI.
Шаблони повторювачів
Повторювачі дають користувачам змогу додавати кілька рядків полів. Вони незамінні для списків, сіток, часових шкал та будь-яких компонентів зі змінною кількістю елементів.
Базовий повторювач з обмеженнями
Список переваг із 1–6 пунктів:
{
"id": "features",
"type": "repeater",
"label": "Features",
"min": 1,
"max": 6,
"textButton": "Add Feature",
"attributes": [
{ "id": "icon", "type": "icon", "label": "Icon" },
{ "id": "title", "type": "text", "label": "Title", "default": "Feature" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
<div useBlockProps class="grid grid-cols-3 gap-8">
<?php foreach ( $a['features'] as $feature ) : ?>
<div>
<?php if ( $feature['icon'] ) : ?>
<?php bs_render_icon( $feature['icon'] ); ?>
<?php endif; ?>
<h3><?php echo esc_html( $feature['title'] ); ?></h3>
<p><?php echo esc_html( $feature['description'] ); ?></p>
</div>
<?php endforeach; ?>
</div>
Власні мітки рядків
За замовчуванням у згорнутих рядках повторювача відображається загальна мітка. Використовуйте textMinimized, щоб замість неї показати значення поля:
{
"id": "team",
"type": "repeater",
"label": "Team Members",
"textMinimized": { "id": "name", "fallback": "Team Member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "photo", "type": "files", "label": "Photo", "multiple": false }
]
}
Коли рядок згорнуто, замість “Row 1” відображається ім’я людини. Якщо поле імені порожнє, використовується fallback. Також можна додати рядки prefix і suffix.
Умови в повторювачах
Поля всередині повторювача можуть посилатися на інші поля того самого рядка за звичайним id (префікс не потрібен):
{
"id": "links",
"type": "repeater",
"label": "Links",
"attributes": [
{ "id": "label", "type": "text", "label": "Label" },
{ "id": "url", "type": "link", "label": "URL" },
{
"id": "isExternal",
"type": "toggle",
"label": "External Link"
},
{
"id": "externalNote",
"type": "message",
"label": "Note",
"description": "External links open in a new tab with rel=\"noopener\".",
"conditions": [[{ "id": "isExternal", "operator": "==", "value": true }]]
}
]
}
Посилання на зовнішні поля з повторювача
Якщо умова в повторювачі має перевірити поле поза ним, додайте "context": "main":
{
"id": "showDescriptions",
"type": "toggle",
"label": "Show Descriptions",
"default": true
},
{
"id": "items",
"type": "repeater",
"label": "Items",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{
"id": "description",
"type": "textarea",
"label": "Description",
"conditions": [[{
"id": "showDescriptions",
"operator": "==",
"value": true,
"context": "main"
}]]
}
]
}
Без "context": "main" умова шукала б поле showDescriptions у рядку повторювача. З ним вона перевіряє перемикач на кореневому рівні.
Вкладки всередині повторюваних блоків
Вкладки недоступні всередині повторюваних блоків: поле tabs у рядку такого блоку замість своїх полів показує сповіщення в редакторі, а розширення PHPStan повідомляє про це. Натомість розміщуйте поля рядка на одному рівні. Для довгих рядків власна назва рядка (textMinimized) полегшує перегляд згорнутих рядків, а умови всередині рядка можуть приховувати поля, потрібні лише для деяких рядків, як показано у прикладах вище.
Установіть "minimized": true для повторюваного блоку, щоб наявні рядки спочатку були згорнуті. Щойно додані рядки одразу розгортаються. Винятки, які було розгорнуто, зберігаються в цьому браузері після перезавантаження редактора; це налаштування редагування, а не вміст збереженої публікації.
Повторювані блоки без minimized і далі за замовчуванням розгорнуті.
Шаблони медіаданих
Одне зображення із запасним варіантом
{
"id": "image",
"type": "files",
"label": "Image",
"multiple": false
}
<?php if ( $a['image'] ) : ?>
<img
src="<?php echo esc_url( $a['image']['url'] ); ?>"
alt="<?php echo esc_attr( $a['image']['alt'] ); ?>"
<?php if ( isset( $a['image']['sizes']['full-width'], $a['image']['sizes']['full-height'] ) ) : ?>
width="<?php echo esc_attr( $a['image']['sizes']['full-width'] ); ?>"
height="<?php echo esc_attr( $a['image']['sizes']['full-height'] ); ?>"
<?php endif; ?>
/>
<?php endif; ?>
За замовчуванням returnFormat має значення "object", що надає ID, title, alt, caption, description, href, url і sizes. sizes містить URL кожного зареєстрованого розміру зображення (sizes['large']) та його розміри (sizes['large-width'], sizes['large-height']). Повний перелік див. у розділі Атрибути рендерингу.
Галерея з обмеженням
{
"id": "gallery",
"type": "files",
"label": "Gallery",
"multiple": true,
"max": 6,
"allowedTypes": ["image"]
}
<?php if ( $a['gallery'] ) : ?>
<div class="grid grid-cols-3 gap-4">
<?php foreach ( $a['gallery'] as $image ) : ?>
<img
src="<?php echo esc_url( $image['url'] ); ?>"
alt="<?php echo esc_attr( $image['alt'] ); ?>" />
<?php endforeach; ?>
</div>
<?php endif; ?>
Зображення, яке можна вимкнути перемикачем
Властивість switch додає піктограму ока, за допомогою якої можна вимкнути поле, не видаляючи його значення:
{
"id": "logo",
"type": "files",
"label": "Logo",
"multiple": false,
"switch": true
}
<?php
$is_disabled = ! empty( $a['_disabled'] ) && in_array( 'logo', $a['_disabled'], true );
if ( $a['logo'] && ! $is_disabled ) : ?>
<img src="<?php echo esc_url( $a['logo']['url'] ); ?>" alt="" />
<?php endif; ?>
Користувач може вимкнути логотип, не видаляючи завантажений файл. Якщо ввімкнути його знову, той самий файл з’явиться знову.
Варіанти формату повернення
Керуйте тим, що повертає поле файлів:
// Full object (default)
{ "id": "photo", "type": "files", "returnFormat": "object", "multiple": false }
// $a['photo']['url'], $a['photo']['alt'], $a['photo']['sizes']['full-width'], etc.
// Just the ID
{ "id": "photo", "type": "files", "returnFormat": "id", "multiple": false }
// $a['photo'] = 42
// Just the URL
{ "id": "photo", "type": "files", "returnFormat": "url", "multiple": false }
// $a['photo'] = "https://example.com/photo.jpg"
Використовуйте "id", якщо потрібно самостійно викликати wp_get_attachment_image(). Для простих фонових зображень використовуйте "url". Для всього іншого — "object" (значення за замовчуванням).
З "returnFormat": "id" імпортоване текстове посилання, як-от "buckshair-home", передається без змін. Редактор показує картку-заповнювач без мініатюри, зокрема в рядках повторюваних блоків. Відкриття чи збереження сторінки не перетворює скалярне посилання на масив. Також підтримуються змішані списки з ідентифікаторів вкладень і текстових посилань; у медіатеці шукаються лише додатні ідентифікатори вкладень.
Blockstudio не зіставляє власні текстові посилання з вкладеннями. Якщо ви використовуєте переносні назви на різних сайтах, зіставте їх у власному фільтрі рендерингу або шаблоні. Як і зазвичай, вибір заміни в медіатеці зберігає ідентифікатор вкладення.
Динамічні параметри
Заповнення записами
Поле списку вибору з усіма опублікованими сторінками:
{
"id": "linkedPage",
"type": "select",
"label": "Linked Page",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "page",
"post_status": "publish",
"posts_per_page": -1
}
}
}
Поле автоматично заповнюється назвами сторінок як мітками та ID записів як значеннями. Використовуйте returnFormat у конфігурації заповнення, щоб налаштувати відповідність:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Заповнення термінами таксономії
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Заповнення функцією PHP
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Статичні параметри з динамічними доповненнями
Поєднуйте задані вручну параметри з динамічними. Використовуйте position, щоб керувати розташуванням заповнених параметрів:
{
"id": "source",
"type": "select",
"label": "Source",
"options": [
{ "value": "manual", "label": "Manual Entry" },
{ "value": "latest", "label": "Latest Posts" }
],
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"position": "after"
}
}
Спочатку відображаються статичні параметри, а потім динамічно завантажені сторінки.
Зберігання даних для запитів
За замовчуванням значення полів зберігаються в атрибутах блоків у post_content. Їх не можна використовувати для запитів WP_Query. Щоб фільтрувати чи сортувати записи за значенням поля, використовуйте сховище.
Метадані запису для полів, доступних у запитах
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
},
{
"id": "priority",
"type": "number",
"label": "Priority",
"default": 0,
"min": 0,
"max": 100,
"storage": {
"type": "postMeta",
"postMetaKey": "priority_score"
}
}
Тепер можна запитувати вибрані записи:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
Мета-ключі автоматично реєструються за допомогою show_in_rest, тож вони також доступні в REST API.
Подвійне зберігання
Зберігайте дані і в атрибутах блоків, і в метаданих запису. Атрибут блоку забезпечує доступність значення в шаблонах через $a, а метадані запису дають змогу використовувати його в запитах:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Зберігання глобальних значень у параметрах
Для загальних налаштувань сайту, які мають бути однаковими всюди, використовуйте зберігання в параметрах:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
Значення зберігається в wp_options і доступне звідусіль через get_option('site_company_name'). Коли користувач редагує це поле в будь-якому екземплярі блока, значення оновлюється глобально.
Повторно використовувані визначення полів
Якщо кілька блоків мають однакову структуру полів, визначте її один раз як власне поле й використовуйте скрізь.
Створення власного поля
Створіть field.json у каталозі blockstudio/fields/ своєї теми:
theme/
└── blockstudio/
└── fields/
└── cta/
└── field.json
{
"name": "cta",
"title": "Call to Action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button Label", "default": "Learn More" },
{ "id": "url", "type": "link", "label": "Button URL" },
{ "id": "style", "type": "select", "label": "Button Style", "default": "primary", "options": [
{ "value": "primary", "label": "Primary" },
{ "value": "secondary", "label": "Secondary" },
{ "value": "outline", "label": "Outline" }
]}
]
}
Використання власного поля
Додайте посилання на нього в будь-якому блоці за допомогою "type": "custom/cta":
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
Поля CTA вбудовуються в блок. Звертайтеся до них безпосередньо: $a['label'], $a['url'], $a['style'].
Власні поля з префіксами за допомогою idStructure
Якщо те саме власне поле використовується кілька разів, додайте idStructure, щоб додати префікси до ID:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
Поля першого CTA матимуть назви primary_label, primary_url, primary_style. Поля другого — secondary_label тощо.
Перевизначення значень за замовчуванням
Налаштовуйте окремі поля, коли додаєте посилання на власне поле:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
Перевизначення об’єднуються з початковим визначенням. Можна змінити значення за замовчуванням, мітки, умови та будь-які інші властивості.
Шаблони відображення
Перевірка порожніх значень
Більшість типів полів повертають false, коли поле порожнє. Завжди перевіряйте значення перед відображенням:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
Для чисел 0 є допустимим значенням. Використовуйте строге порівняння, якщо потрібно відрізнити «порожнє» від «нуля»:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Список вибору з returnFormat: both
Коли потрібні і значення (для логіки), і мітка (для відображення):
{
"id": "status",
"type": "select",
"label": "Status",
"returnFormat": "both",
"options": [
{ "value": "active", "label": "Active" },
{ "value": "paused", "label": "On Hold" },
{ "value": "closed", "label": "Closed" }
]
}
<?php if ( $a['status'] ) : ?>
<span class="badge badge--<?php echo esc_attr( $a['status']['value'] ); ?>">
<?php echo esc_html( $a['status']['label'] ); ?>
</span>
<?php endif; ?>
Атрибути даних із поля attributes
Тип поля attributes дає змогу користувачам додавати власні атрибути даних:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
Змінні CSS зі значень полів
Створюйте власні властивості CSS з вибраних полів:
{
"id": "textColor", "type": "color", "label": "Text Color"
},
{
"id": "fontSize", "type": "unit", "label": "Font Size", "default": "1rem"
}
<div useBlockProps style="<?php bs_render_variables( $a, array( 'textColor', 'fontSize' ) ); ?>">
<p>Styled content.</p>
</div>
У результаті виводиться style="--text-color: #333; --font-size: 1rem;" (ID полів перетворюються на kebab-case). Використовуйте змінні у своєму CSS:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Наступні кроки
- Реєстрація атрибутів: властивості
id,type,label,default,help,positionіconditions. - Довідник типів полів: автоматично згенерований довідник із кожною властивістю для кожного типу поля.
- Умовна логіка: оператори, глобальні умови, власні фільтри умов і контекст повторювача.
- Заповнення параметрів: режими запиту, функції, власних параметрів і отримання даних для динамічних параметрів поля.
- Власні поля:
field.json, шляхи пошуку, фільтрblockstudio/fieldsі розширені шаблониidStructure. - Відображення:
$a,$b,$c, порожні значення та допоміжні функції.