Komponenter
Blockstudio leveres med 59 UI-komponenter i hver build. De registreres automatisk, styles med designtokens og skrives med samme tagsyntaks som alle andre blokke.
Blockstudio 7.3 indeholder et indbygget sæt headless UI-blokke, der drives af WordPress Interactivity API. De er registreret under navnerummet bsui/* og kan sammensættes i skabeloner, filbaserede sider, mønstre og indlæg.
Bemærk
UI-komponenterne er i betaversion, mens vi indsamler feedback om komponentsættet, navngivningen, funktionaliteten og projektets brugsmønstre. De kan prøves i 7.3, men API-grænsefladen kan stadig blive justeret, før den erklæres stabil.
Aktivér UI-komponenter
De indbyggede UI-komponenter er valgfrie. Aktivér dem i dit temas blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Eller aktivér dem med et filter:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Når Blockstudio er aktiveret, registrerer den komponentbiblioteket fra includes/ui/blocks.
Offentlig oversigt og eksempler
De indbyggede implementeringsblokke forbliver almindelige bsui/*-registreringer, men forbrugere bør bruge den offentlige oversigt over komponentfamilier, når de bygger et komponentgalleri:
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory() grupperer hver sammensat komponent under sin offentlige rod og viser de implementeringsregistreringer, som familien kræver.
Ui::examples() tilføjer en deterministisk, normaliseret deklaration med standarddata og eksempeldata. Den bevarer de nødvendige relationer mellem rod og underordnede elementer, så resultatet kan sendes direkte til Blockstudio\Render::document().
Den offentlige oversigt over Canvas viser disse eksempler under sin ui-type og udelader indbyggede implementeringsregistreringer fra den almindelige blocks-type. Dermed får man ét komplet eksempel for hver offentlig komponentfamilie i stedet for et galleri med interne rod-, udløser-, popup- og lagfragmenter.
Når et allerede gengivet dokument sammensættes, returnerer Ui::global_assets($block_names, $html) kun den præcise indbyggede globale stil og det præcise script, hvis det valgte output faktisk bruger en UI-komponent.
Gengivelse
Brug den almindelige syntaks for bloktags:
<block name="bsui/button" label="Save" variant="default"></block>
Den kortere syntaks <bs:> virker også:
<bs:bsui-button label="Save" variant="default" />
I Blockstudio-skabeloner gengives bloktags automatisk. På filbaserede sider og i mønstre synkroniseres de som indbyggede WordPress-blokke. Hvis du vil gengive UI-komponenter direkte fra indlægsindhold eller widgetområder, skal du aktivere bloktags på sideniveau:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Grundlæggende komponenter
Enkle komponenter gengives som en enkelt blok:
<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>
Attributter knyttes direkte til hver komponents block.json-attributter. For eksempel understøtter bsui/button label, icon, iconPosition, href, variant, size og disabled.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Sammensatte komponenter
Mange UI-komponenter består af flere blokke. Rodblokken ejer tilstanden, og underordnede blokke angiver deres forælder.
Faneblade
<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>
Dialog
<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>
Vælger
<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>
Formularfelter
<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>
Tilgængelige blokke
Det indbyggede UI-bibliotek omfatter:
| Område | Blokke |
|---|---|
| Layout | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| Handlinger | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| Inputfelter | 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 |
| Overlejringer | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| Navigation | 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 |
| Formularer | bsui/field, bsui/field-group, bsui/form |
Sammensatte komponenter viser også underordnede blokke som bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup og bsui/select-option.
Styling
UI-komponenter leveres med deres egne brugerdefinerede CSS-egenskaber med præfikset --bs-ui-*. Du kan tilsidesætte dem i dit temas CSS:
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
Komponenternes funktion er headless, men de har nok faste valg til at kunne bruges direkte. Tilsidesæt tokens først, og tilføj derefter komponentspecifikke CSS efter behov.
Indbygget komponent-CSS udsendes i det navngivne bsui-kaskadelag. Ulagdelt tema-CSS kan tilsidesætte komponentregler uden !important:
.button-brand {
background: var(--brand-primary);
}
Hvis du vil tilføje en brugerdefineret variant af bsui/button, skal du tilføje vælgermuligheden med det eksisterende attributfilter og angive variantens CSS med 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;
}';
});
Relateret
- UI Sammensætning, herunder kontrollerede felter, feltkort og adskillere i værktøjslinjen
- Programmatisk rendering
- Komponenter
- Interaktivitet API