Componente
Blockstudio include 59 UI componente la fiecare compilare. Acestea sunt înregistrate automat, stilizate cu tokenuri de design și scrise folosind aceeași sintaxă de etichete ca orice alt bloc.
Blockstudio 7.3 include un set integrat de blocuri UI fără interfață, bazate pe API-ul WordPress Interactivity API. Acestea sunt înregistrate în spațiul de nume bsui/* și pot fi compuse în șabloane, pagini bazate pe fișiere, tipare și conținutul articolelor.
Notă
Componentele UI sunt în versiune beta în timp ce colectăm feedback despre setul de componente, denumire, comportament și tiparele de utilizare în proiecte. Le puteți încerca în 7.3, dar interfața API poate fi încă îmbunătățită înainte de a fi declarată stabilă.
Activați componentele UI
Componentele UI incluse sunt opționale. Activați-le în fișierul blockstudio.json al temei:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Sau activați-le cu un filtru:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Când sunt activate, Blockstudio înregistrează biblioteca de componente incluse din includes/ui/blocks.
Inventarul public și exemple
Blocurile de implementare incluse rămân înregistrări bsui/* obișnuite, dar
consumatorii ar trebui să folosească inventarul public al familiilor când creează o galerie
de componente:
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory() grupează fiecare componentă compusă sub rădăcina sa publică și
enumeră înregistrările de implementare necesare pentru familia respectivă.
Ui::examples() adaugă o declarație normalizată și deterministă, cu date implicite și
ilustrative. Păstrează relațiile obligatorii dintre rădăcină și elementele copil, astfel încât
rezultatul să poată fi transmis direct către Blockstudio\Render::document().
Inventarul public Canvas expune aceste exemple sub tipul ui și
omite înregistrările de implementare incluse din tipul blocks obișnuit. Astfel,
rezultă un exemplu complet pentru fiecare familie de componente publice, în locul unei galerii
cu fragmente interne de rădăcină, declanșator, fereastră pop-up și strat.
La asamblarea unui document deja redat, Ui::global_assets($block_names, $html) returnează stilul global și scriptul exact incluse numai dacă rezultatul selectat folosește efectiv o componentă UI.
Redare
Folosiți sintaxa obișnuită pentru etichetele blocurilor:
<block name="bsui/button" label="Save" variant="default"></block>
Funcționează și sintaxa mai scurtă <bs:>:
<bs:bsui-button label="Save" variant="default" />
În șabloanele Blockstudio, etichetele blocurilor sunt randate automat. În paginile bazate pe fișiere și în tipare, acestea sunt sincronizate ca blocuri native WordPress. Dacă doriți să redați direct componentele UI din conținutul articolelor sau din zonele de widgeturi, activați etichetele blocurilor la nivel de pagină:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Componente de bază
Componentele simple sunt randate ca un singur bloc:
<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>
Atributele corespund direct atributelor block.json ale fiecărei componente. De exemplu, bsui/button acceptă label, icon, iconPosition, href, variant, size și disabled.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Componente compuse
Multe componente UI sunt blocuri compuse. Blocul rădăcină deține starea, iar blocurile copil își declară blocul părinte.
File
<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>
Selector
<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>
Câmpuri de formular
<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>
Blocuri disponibile
Biblioteca UI inclusă conține:
| Zonă | Blocuri |
|---|---|
| Aspect | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| Acțiuni | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| Intrări | 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 |
| Suprapuneri | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| Navigare | 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 |
| Formulare | bsui/field, bsui/field-group, bsui/form |
Componentele compuse expun și blocuri copil precum bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup și bsui/select-option.
Stilizare
Componentele UI vin cu propriile proprietăți personalizate CSS, folosind prefixul --bs-ui-*. Le puteți suprascrie din CSS temei:
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
Componentele nu impun un comportament vizual, dar au suficiente opinii implicite pentru a putea fi folosite imediat. Suprascrieți mai întâi tokenurile, apoi adăugați CSS specifice componentelor, acolo unde este nevoie.
CSS componentelor incluse este generat în stratul numit bsui al cascadei. CSS temei, fără strat, poate suprascrie regulile componentelor fără !important:
.button-brand {
background: var(--brand-primary);
}
Pentru a adăuga o variantă personalizată bsui/button, adăugați opțiunea selectorului prin filtrul de atribute
existent și furnizați CSS variantei cu 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;
}';
});
Pagini asociate
- UICompoziție, inclusiv câmpuri controlate, carduri pentru câmpuri și separatoare pentru bara de instrumente
- Redare programatică
- Componente
- Interactivitate API