Komponente
Blockstudio vključuje 59 UI komponent z vsako gradnjo. Registrirajo se samodejno, oblikujejo z oblikovnimi žetoni in ustvarijo z enako sintakso značk kot kateri koli drug blok.
Blockstudio 7.3 vključuje nabor brezglavih blokov UI, ki jih poganja WordPress Interactivity API. Registrirani so pod imenskim prostorom bsui/* in jih je mogoče sestavljati v predlogah, datotečnih straneh, vzorcih in vsebini objav.
Opomba
Komponente UI so v različici beta, medtem ko zbiramo povratne informacije o naboru komponent, poimenovanju, delovanju in vzorcih uporabe v projektih. Preizkusite jih lahko v različici 7.3, vendar se lahko površina API še izboljša, preden jo označimo kot stabilno.
Omogočite komponente UI
Priložene komponente UI so neobvezne. Omogočite jih v datoteki blockstudio.json svoje teme:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Lahko pa jih omogočite s filtrom:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Ko so omogočene, Blockstudio registrira priloženo knjižnico komponent iz includes/ui/blocks.
Javni seznam in primeri
Priloženi bloki za implementacijo ostanejo običajne registracije bsui/*, vendar naj uporabniki pri ustvarjanju galerije komponent uporabijo javni seznam družin:
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory() združi vsako sestavljeno komponento pod njenim javnim korenom
in navede registracije implementacij, ki jih ta družina potrebuje.
Ui::examples() doda deterministično normalizirano deklaracijo s privzetimi
in ponazoritvenimi podatki. Ohrani zahtevana razmerja med koreni in podrejenimi elementi, zato
lahko rezultat neposredno posredujete v Blockstudio\Render::document().
Javni seznam Canvas te primere izpostavlja pod svojim tipom ui in
iz običajnega tipa blocks izpušča priložene registracije implementacij. Tako nastane
po en celovit primer za vsako javno družino komponent, namesto galerije notranjih fragmentov korenov, sprožilcev, pojavnih oken in plasti.
Pri sestavljanju že izrisanega dokumenta Ui::global_assets($block_names, $html) vrne točno določena priložena globalna sloga in skript samo, če izbrani
izhod dejansko uporablja komponento UI.
Izrisovanje
Uporabite običajno sintakso oznak blokov:
<block name="bsui/button" label="Save" variant="default"></block>
Deluje tudi krajša sintaksa <bs:>:
<bs:bsui-button label="Save" variant="default" />
V predlogah Blockstudio se oznake blokov izrišejo samodejno. Na datotečnih straneh in v vzorcih se sinhronizirajo kot izvorni bloki WordPress. Če želite komponente UI izrisati neposredno iz vsebine objav ali območij gradnikov, omogočite oznake blokov na ravni strani:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Osnovne komponente
Preproste komponente se izrišejo kot en sam 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>
Atributi se neposredno preslikajo v atribute block.json posamezne komponente. Komponenta bsui/button na primer podpira label, icon, iconPosition, href, variant, size in disabled.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Sestavljene komponente
Številne komponente UI so sestavljeni bloki. Korenski blok upravlja stanje, podrejeni bloki pa določijo svoj nadrejeni blok.
Zavihki
<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>
Izbirnik
<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>
Polja obrazca
<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>
Razpoložljivi bloki
Priložena knjižnica UI vključuje:
| Območje | Bloki |
|---|---|
| Postavitev | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| Dejanja | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| Vnosi | 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 |
| Prekrivni elementi | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| Krmarjenje | bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs |
| Povratne informacije | bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast |
| Obrazci | bsui/field, bsui/field-group, bsui/form |
Sestavljene komponente izpostavljajo tudi podrejene bloke, kot so bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup in bsui/select-option.
Slogi
Komponente UI imajo lastne lastnosti po meri CSS s predpono --bs-ui-*. Preglasite jih lahko v CSS svoje teme:
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
Komponente so po vedenju brezglave, vendar dovolj usmerjene, da jih lahko uporabite takoj. Najprej preglasite žetone, nato po potrebi dodajte slogovna pravila CSS za posamezne komponente.
Slogi priloženih komponent CSS so izpisani v imenovani kaskadni plasti bsui. Slogi CSS teme brez plasti lahko preglasijo pravila komponent brez !important:
.button-brand {
background: var(--brand-primary);
}
Če želite dodati različico po meri za bsui/button, dodajte možnost izbirnika s filtrom obstoječih atributov in določite CSS različice z 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;
}';
});
Povezano
- UISestavljanje, vključno z nadzorovanimi polji, karticami polj in ločili v orodni vrstici
- Programatsko upodabljanje
- Komponente
- Interaktivnost API