Компоненти
Blockstudio включва 59 UI компонента във всяка компилация. Те се регистрират автоматично, стилизират се с токени за дизайн и се създават със същия синтаксис на тагове като всеки друг блок.
Blockstudio 7.3 включва пакет от безглави блокове UI, задвижвани от WordPress Interactivity API. Те са регистрирани в пространството от имена bsui/* и могат да се комбинират в шаблони, файлови страници, образци и съдържание на публикации.
Забележка
Компонентите UI са в бета-версия, докато събираме обратна връзка за набора от компоненти, именуването, поведението и моделите на използване в проектите. Могат да се изпробват във версия 7.3, но интерфейсът API може да бъде променен, преди да бъде обявен за стабилен.
Активиране на компонентите UI
Пакетните компоненти UI са незадължителни. Активирайте ги в blockstudio.json на темата си:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Или ги активирайте с филтър:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Когато са активирани, Blockstudio регистрира библиотеката от пакетни компоненти от includes/ui/blocks.
Публичен списък и примери
Пакетните блокове за реализация остават обичайни регистрации bsui/*, но
при изграждането на галерия от компоненти трябва да се използва публичният списък на компонентите:
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory() групира всеки съставен компонент под неговия публичен корен
и изброява необходимите регистрации за реализация на това семейство.
Ui::examples() добавя детерминистична нормализирана декларация с данни по подразбиране
и примерни данни. Тя запазва задължителните връзки между корена и дъщерните блокове, така че
резултатът може директно да се подаде на Blockstudio\Render::document().
Публичният списък на Canvas показва тези примери в типа ui и
изключва пакетните регистрации за реализация от обичайния тип blocks. Така се получава
по един цялостен пример за всяко публично семейство компоненти, вместо галерия
от вътрешни фрагменти на корен, задействащ елемент, изскачащ прозорец и слой.
При сглобяване на вече изобразен документ Ui::global_assets($block_names, $html) връща точния пакетен глобален стил и скрипт само когато избраният
изход действително използва компонент UI.
Визуализиране
Използвайте обичайния синтаксис на таговете за блокове:
<block name="bsui/button" label="Save" variant="default"></block>
Също така работи и съкратеният синтаксис <bs:>:
<bs:bsui-button label="Save" variant="default" />
В шаблоните Blockstudio таговете за блокове се визуализират автоматично. Във файлови страници и образци те се синхронизират като вградени блокове WordPress. За да визуализирате компоненти UI директно от съдържанието на публикация или области с уиджети, активирайте таговете за блокове на ниво страница:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Основни компоненти
Простите компоненти се визуализират като един блок:
<block name="bsui/button" label="Continue" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
name="bsui/input"
nameAlt="email"
type="email"
placeholder="Email"
></block>
<block name="bsui/textarea" name="message" placeholder="Message"></block>
<block name="bsui/spinner"></block>
Атрибутите се съпоставят директно с атрибутите block.json на всеки компонент. Например bsui/button поддържа label, icon, iconPosition, href, variant, size и disabled.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Съставни компоненти
Много компоненти UI се състоят от няколко блока. Коренният блок управлява състоянието, а дъщерните блокове декларират своя родител.
Раздели
<block name="bsui/tabs" defaultValue="tab1">
<block name="bsui/tabs-list">
<block name="bsui/tabs-trigger" value="tab1" title="Features"></block>
<block name="bsui/tabs-trigger" value="tab2" title="Pricing"></block>
<block name="bsui/tabs-trigger" value="tab3" title="FAQ"></block>
</block>
<block name="bsui/tabs-panel" value="tab1">
<p>Features content.</p>
</block>
<block name="bsui/tabs-panel" value="tab2">
<p>Pricing content.</p>
</block>
<block name="bsui/tabs-panel" value="tab3">
<p>FAQ content.</p>
</block>
</block>
Диалогов прозорец
<block name="bsui/dialog">
<block name="bsui/dialog-trigger" label="Open Dialog"></block>
<block name="bsui/dialog-backdrop"></block>
<block name="bsui/dialog-popup">
<p>Dialog content.</p>
<block name="bsui/dialog-close" label="Close"></block>
</block>
</block>
Списък за избор
<block name="bsui/select" placeholder="Choose a fruit" nameAlt="fruit">
<block name="bsui/select-trigger"></block>
<block name="bsui/select-popup">
<block name="bsui/select-option" value="apple" label="Apple"></block>
<block name="bsui/select-option" value="banana" label="Banana"></block>
<block name="bsui/select-option" value="cherry" label="Cherry"></block>
</block>
</block>
Полета на формуляра
<block name="bsui/form" block="contact/form" successMessage="Thank you!">
<block name="bsui/field">
<block name="bsui/field-label" text="Email"></block>
<block name="bsui/input" nameAlt="email" type="email"></block>
<block name="bsui/field-error"></block>
</block>
</block>
Налични блокове
Пакетната библиотека UI включва:
| Област | Блокове |
|---|---|
| Оформление | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| Действия | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| Входни данни | bsui/checkbox, bsui/color-picker, bsui/date-input, bsui/file-upload, bsui/input, bsui/number-field, bsui/otp-input, bsui/password-input, bsui/phone-input, bsui/radio-group, bsui/rating, bsui/select, bsui/slider, bsui/switch, bsui/textarea, bsui/time-picker |
| Наслагвания | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| Навигация | bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs |
| Обратна връзка | bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast |
| Формуляри | bsui/field, bsui/field-group, bsui/form |
Съставните компоненти предоставят и дъщерни блокове, като bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup и bsui/select-option.
Стилизиране
Компонентите UI се доставят със собствени персонализирани свойства CSS, използващи префикса --bs-ui-*. Можете да ги презапишете от CSS на темата си:
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
Компонентите не задават поведението според конкретен стил, но предлагат достатъчно ясни решения, за да могат да се използват веднага. Първо презапишете токените, а след това при необходимост добавете специфични за компонента CSS.
CSS на пакетния компонент се генерира в именувания слой bsui на каскадата. Необвързаният със слой CSS на темата може да презаписва правилата на компонента без !important:
.button-brand {
background: var(--brand-primary);
}
За да добавите персонализиран вариант bsui/button, добавете опция за списъка за избор със съществуващия филтър за атрибути
и предоставете варианта CSS с
blockstudio/ui/button/variants-style:
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (($block['name'] ?? '') === 'bsui/button' && ($attribute['id'] ?? '') === 'variant') {
$attribute['options'][] = [
'label' => 'Brand',
'value' => 'brand',
];
}
return $attribute;
}, 10, 2);
add_filter('blockstudio/ui/button/variants-style', function($css) {
return $css . '
[data-bsui-button][data-variant="brand"] {
background: var(--brand-primary);
color: white;
}';
});
Свързани теми
- UI Композиция, включително контролирани полета, карти с полета и разделители в лентата с инструменти
- Програмно визуализиране
- Компоненти
- Интерактивност API