Treci la conținut

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:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

Sau activați-le cu un filtru:

PHP
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:

PHP
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:

HTML
<block name="bsui/button" label="Save" variant="default"></block>

Funcționează și sintaxa mai scurtă <bs:>:

HTML
<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ă:

JSON
{
  "ui": {
    "enabled": true
  },
  "blockTags": {
    "enabled": true,
    "allow": ["bsui/*", "app/*"]
  }
}

Componente de bază

Componentele simple sunt randate ca un singur bloc:

HTML
<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.

PHP
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

HTML
<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

HTML
<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

HTML
<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

HTML
<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:

CSS
: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:

CSS
.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:

PHP
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;
}';
});

Toate componentele

Acordeon Secțiuni suprapuse care deschid câte un panou pe rând. Dialog de alertă O fereastră modală care întrerupe fluxul și cere un răspuns înainte de a se închide. Raport de aspect Blochează conținutul la un raport fix între lățime și înălțime. Avatar O imagine de utilizator înlocuită cu inițialele dacă nu se încarcă. Insignă O etichetă mică pentru stare, numărători și categorii. Breadcrumb Arată poziția paginii curente în ierarhie. Buton Declanșează o acțiune, cu variante pentru fiecare nivel de accentuare. Grup de butoane Unește butoanele asociate într-un singur control segmentat. Calendar O grilă calendaristică pentru selectarea unei singure zile. Card Un container care grupează un antet, un corp și un subsol. Carusel O bandă de diapozitive navigabilă prin glisare, cu suport pentru tastatură. Casetă de selectare O alegere binară care acceptă și o stare nedeterminată. Restrângibil Ascunde și afișează o singură regiune de conținut. Selector de culoare Selectează o culoare și o trimite împreună cu formularul din care face parte. Selector combinat Un câmp text care filtrează o listă de opțiuni pe măsură ce tastați. Meniu contextual Acțiuni afișate la clic dreapta și ancorate la cursor. Câmp de introducere a datei Un câmp cu mască pentru introducerea datelor fără un selector. Dialog Un strat modal pentru activități care cer concentrare și confirmări. Panou glisant Un panou care glisează din orice margine a ecranului. Câmp Încadrează un control împreună cu eticheta, descrierea și eroarea sa. Grup de câmpuri Grupează câmpuri asociate sub un titlu comun. Încărcare de fișiere O zonă de încărcare și un selector de fișiere cu suport pentru mai multe fișiere. Formular Trimite câmpurile și semnalează succesul fără reîncărcarea paginii. Introducere Un câmp text pe un singur rând pentru toate tipurile obișnuite de introducere. Scurtătură de la tastatură Afișează o scurtătură de la tastatură în propria tastă. Etichetă O legendă pentru un control, comună tuturor componentelor etichetate. Meniu O listă derulantă de acțiuni ancorată la un declanșator. Bară de meniu O bară orizontală de meniuri, ca într-o aplicație desktop. Indicator Arată o măsurătoare într-un interval cunoscut. Meniu de navigare Navigarea site-ului cu linkuri imbricate și panouri afișate la trecerea cursorului. Câmp numeric Un câmp numeric cu butoane de incrementare și decrementare și un interval limitat. Câmp pentru cod OTP Casete separate pentru introducerea unui cod de acces de unică folosință. Paginare Linkuri către pagini, cu opțiuni pentru pagina anterioară, următoare și trunchiere. Câmp pentru parolă Un câmp pentru parolă cu un comutator de afișare. Câmp pentru număr de telefon Un câmp pentru numărul de telefon, cu selectarea țării și formatare. Fereastră popover Conținut îmbogățit, ancorat la un declanșator și închis la clic în exterior. Card de previzualizare Un card afișat la trecerea cursorului, care previzualizează destinația unui link. Progres Arată progresul unei activități. Grup de butoane radio Un set de opțiuni din care poate fi selectată exact una. Evaluare Un control cu stele pentru acordarea unui punctaj. Zonă de derulare Un container cu derulare și bare de derulare suprapuse, stilizate. Selectați O listă derulantă pentru alegerea unei opțiuni. Separator O linie care separă conținutul sau grupează controalele. Schelet O formă substituent afișată cât timp se încarcă conținutul. Glisor Selectează o valoare sau un interval prin glisare de-a lungul unei piste. Spațiu Un pas vertical fix de ritm, din scara de spațiere. Indicator rotativ Indică o activitate în desfășurare cu durată necunoscută. Stivă Aranjează elementele copil pe un rând sau într-o coloană, cu spațiere uniformă. Comutator Comută o setare care se aplică imediat. Tabel Date tabelare cu sortare și alternarea opțională a culorii rândurilor. File Comută între panouri care ocupă același spațiu. Text Randează text la o dimensiune și într-un element semantic alese. Zonă de text Un câmp text pe mai multe rânduri, care se extinde odată cu numărul de rânduri. Selector de oră Selectează o oră din zi, la un interval ales. Furnizor de notificări toast Afișează notificări temporare într-un colț al ecranului. Comutare Un buton care rămâne apăsat pentru a reprezenta starea activată. Grup de comutare Un set de comutatoare care permite alegerea uneia sau a mai multor opțiuni. Bară de instrumente Un rând de controale între care se poate muta focalizarea. Indiciu Un indiciu scurt afișat la trecerea cursorului sau la focalizare.