Сборник с рецепти за полета
Системата за полета на 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" }
]]
}
Полето за alt текст се показва само когато 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 }
]
}
Когато редът е свит, вместо „Ред 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", се предава без промяна. Редакторът показва резервна карта без миниатюра, включително в редовете на повторителите. Отварянето или запазването на страницата не преобразува скаларна препратка в масив. Работят и смесени списъци с ID-та на прикачени файлове и препратки от низ; в медийната библиотека се търсят само положителни ID-та на прикачени файлове.
Blockstudio не разрешава персонализирани препратки от низ към прикачени файлове. Разрешавайте ги в собствен филтър за визуализиране или шаблон, когато използвате преносими имена в различни сайтове. Избирането на замяна в медийната библиотека запазва обичайния ID на прикачения файл.
Динамични опции
Попълване от публикации
Падащо меню, което показва всички публикувани страници:
{
"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, празни стойности и помощни функции.