Componenten
Blockstudio bevat bij elke build 59 UI componenten. Ze worden automatisch geregistreerd, opgemaakt met ontwerptokens en geschreven met dezelfde tagsyntaxis als elk ander blok.
Blockstudio 7.3 bevat een meegeleverde set headless UI-blokken die worden aangedreven door de WordPress Interactivity API. Ze zijn geregistreerd onder de namespace bsui/* en kunnen worden samengesteld in templates, pagina's met bestandsstructuur, patronen en berichtinhoud.
Opmerking
UI-componenten zijn in bèta terwijl we feedback verzamelen over de componentenset, de naamgeving, het gedrag en gebruikspatronen in projecten. Je kunt ze uitproberen in 7.3, maar de API-interface kan nog worden aangepast voordat deze stabiel wordt verklaard.
UI-componenten inschakelen
Meegeleverde UI-componenten zijn optioneel. Schakel ze in via blockstudio.json van je thema:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Of schakel ze in met een filter:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Als ze zijn ingeschakeld, registreert Blockstudio de meegeleverde componentenbibliotheek vanuit includes/ui/blocks.
Openbare inventaris en voorbeelden
De meegeleverde implementatieblokken blijven gewone bsui/*-registraties, maar consumenten kunnen bij het samenstellen van een componentengalerij beter de openbare inventaris van componentfamilies gebruiken:
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory() groepeert elke samengestelde component onder de openbare hoofdcomponent en vermeldt de implementatieregistraties die voor die familie nodig zijn.
Ui::examples() voegt een deterministische, genormaliseerde declaratie met standaard- en voorbeeldgegevens toe. De vereiste relaties tussen hoofd- en onderliggende componenten blijven behouden, zodat het resultaat direct aan Blockstudio\Render::document() kan worden doorgegeven.
De openbare Canvas-inventaris toont deze voorbeelden onder het type ui en laat meegeleverde implementatieregistraties weg uit het gewone type blocks. Zo ontstaat één compleet voorbeeld per openbare componentfamilie, in plaats van een galerij met interne fragmenten voor hoofdcomponenten, triggers, popups en lagen.
Bij het samenstellen van een al weergegeven document geeft Ui::global_assets($block_names, $html) de exacte meegeleverde globale stijl en het script alleen terug wanneer de geselecteerde uitvoer daadwerkelijk een UI-component gebruikt.
Renderen
Gebruik de gewone syntaxis voor bloktags:
<block name="bsui/button" label="Save" variant="default"></block>
De kortere syntaxis <bs:> werkt ook:
<bs:bsui-button label="Save" variant="default" />
In templates van Blockstudio worden bloktags automatisch weergegeven. Op pagina's met bestandsstructuur en in patronen worden ze gesynchroniseerd als native WordPress-blokken. Als je UI-componenten rechtstreeks uit berichtinhoud of widgetgebieden wilt weergeven, schakel dan bloktags op paginaniveau in:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Basiscomponenten
Eenvoudige componenten worden als één blok weergegeven:
<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>
Attributen komen rechtstreeks overeen met de block.json-attributen van elke component. Zo ondersteunt bsui/button label, icon, iconPosition, href, variant, size en disabled.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Samengestelde componenten
Veel UI-componenten bestaan uit meerdere blokken. Het hoofdblok beheert de status en onderliggende blokken geven hun bovenliggende blok op.
Tabbladen
<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>
Dialoogvenster
<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>
Select
<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>
Formuliervelden
<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>
Beschikbare blokken
De meegeleverde UI-bibliotheek bevat:
| Gebied | Blokken |
|---|---|
| Indeling | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| Acties | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| Invoer | 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 |
| Overlays | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| Navigatie | bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs |
| Feedback | bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast |
| Formulieren | bsui/field, bsui/field-group, bsui/form |
Samengestelde componenten bevatten ook onderliggende blokken, zoals bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup en bsui/select-option.
Vormgeving
UI-componenten worden geleverd met eigen CSS-custom properties met het voorvoegsel --bs-ui-*. Je kunt deze overschrijven vanuit CSS van je thema:
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
De componenten hebben geen ingebouwd gedrag, maar bieden genoeg houvast om meteen bruikbaar te zijn. Overschrijf eerst de tokens en voeg daarna waar nodig componentspecifieke CSS toe.
De gebundelde component CSS wordt uitgegeven in de benoemde bsui-cascadelaag. Een thema CSS zonder laag kan componentregels overschrijven zonder !important:
.button-brand {
background: var(--brand-primary);
}
Als je een aangepaste variant van bsui/button wilt toevoegen, voeg dan de selectoptie toe met het bestaande attributenfilter en geef de variant-CSS op met 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;
}';
});
Gerelateerd
- UI Samenstelling, waaronder gecontroleerde velden, veldkaarten en scheidingstekens voor de werkbalk
- Programmatische weergave
- Componenten
- Interactiviteit API