Komponenti
Blockstudio katrā būvējumā iekļauj 59 UI komponentus. Tie tiek reģistrēti automātiski, veidoti ar dizaina marķieriem un rakstīti, izmantojot to pašu tagu sintaksi kā jebkuram citam blokam.
Blockstudio 7.3 ietver komplektā iekļautu bezsaskarnes UI bloku kopu, ko darbina WordPress Interactivity API. Tie ir reģistrēti bsui/* nosaukumvietā, un tos var kombinēt veidnēs, failos balstītās lapās, paraugos un ziņu saturā.
Piezīme
UI komponenti ir beta versijā, kamēr apkopojam atsauksmes par komponentu kopu, nosaukumiem, darbību un lietošanas modeļiem projektos. Tos var izmēģināt versijā 7.3, taču API saskarne vēl var tikt pilnveidota, pirms tā tiks atzīta par stabilu.
Iespējojiet UI komponentus
Komplektā iekļautie UI komponenti pēc noklusējuma ir izslēgti. Iespējojiet tos motīva blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Vai iespējojiet tos ar filtru:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Kad iespējots, Blockstudio reģistrē komplektā iekļauto komponentu bibliotēku no includes/ui/blocks.
Publiskais saraksts un piemēri
Komplektā iekļautie implementācijas bloki joprojām ir parastas bsui/* reģistrācijas, taču, veidojot komponentu galeriju, lietotājiem vajadzētu izmantot publisko saimju sarakstu:
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory() grupē katru salikto komponentu zem tā publiskā saknes elementa un uzskaita šai saimei vajadzīgās implementācijas reģistrācijas.
Ui::examples() pievieno deterministisku, normalizētu deklarāciju ar noklusējuma un ilustratīvajiem datiem. Tā saglabā obligātās saknes un bērnelementu attiecības, tāpēc rezultātu var tieši nodot Blockstudio\Render::document().
Publiskais Canvas saraksts rāda šos piemērus ar tipu ui un izslēdz komplektā iekļautās implementācijas reģistrācijas no parastā tipa blocks. Tādējādi katrai publiskajai komponentu saimei ir viens pilnīgs piemērs, nevis galerija ar iekšējiem saknes elementu, aktivizētāju, uznirstošo logu un slāņu fragmentiem.
Sagatavojot jau attēlotu dokumentu, Ui::global_assets($block_names, $html) atgriež precīzu komplektā iekļauto globālo stilu un skriptu tikai tad, ja atlasītajā izvadē faktiski tiek izmantots komponents UI.
Renderēšana
Izmantojiet parasto bloka tagu sintaksi:
<block name="bsui/button" label="Save" variant="default"></block>
Darbojas arī īsākā sintakse <bs:>:
<bs:bsui-button label="Save" variant="default" />
Veidnēs Blockstudio bloku tagi tiek attēloti automātiski. Failos balstītās lapās un paraugos tie tiek sinhronizēti kā vietējie WordPress bloki. Ja vēlaties attēlot UI komponentus tieši no ziņu satura vai logrīku apgabaliem, iespējojiet lapas līmeņa bloku tagus:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Pamata komponenti
Vienkārši komponenti tiek attēloti kā viens bloks:
<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>
Atribūti tiek tieši sasaistīti ar katra komponenta block.json atribūtiem. Piemēram, bsui/button atbalsta label, icon, iconPosition, href, variant, size un disabled.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Saliktie komponenti
Daudzi UI komponenti ir salikti bloki. Saknes bloks pārvalda stāvokli, bet bērnu bloki norāda savu vecāku.
Cilnes
<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>
Dialoglodziņš
<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>
Atlase
<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>
Veidlapas lauki
<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>
Pieejamie bloki
Komplektā iekļautajā UI bibliotēkā ir:
| Joma | Bloki |
|---|---|
| Izkārtojums | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| Darbības | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| Ievade | 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 |
| Pārklājumi | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| Navigācija | bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs |
| Atsauksmes | bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast |
| Veidlapas | bsui/field, bsui/field-group, bsui/form |
Saliktajiem komponentiem ir arī tādi bērnu bloki kā bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup un bsui/select-option.
Stili
UI komponenti ir aprīkoti ar saviem CSS pielāgotajiem rekvizītiem, kuru prefikss ir --bs-ui-*. Tos varat pārrakstīt motīva CSS:
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
Komponentu darbība ir bezsaskarnes, tomēr to uzskati ļauj tos uzreiz lietot. Vispirms pārrakstiet tokenus, pēc tam pievienojiet komponentam specifisku CSS, ja nepieciešams.
Komplektā iekļautie komponentu CSS tiek izvadīti nosauktajā kaskādes slānī bsui. Motīva CSS, kas nav slāņots, var pārrakstīt komponentu kārtulas bez !important:
.button-brand {
background: var(--brand-primary);
}
Lai pievienotu pielāgotu bsui/button variantu, pievienojiet atlases opciju ar esošo atribūtu filtru un norādiet varianta CSS, izmantojot 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;
}';
});
Saistītās tēmas
- UI Kompozīcija, tostarp vadīti lauki, lauku kartītes un rīkjoslas atdalītāji
- Programmatiska renderēšana
- Komponenti
- Interaktivitāte API