Μετάβαση στο περιεχόμενο

Στοιχεία

Το Blockstudio περιλαμβάνει 59 UI στοιχεία σε κάθε έκδοση. Εγγράφονται αυτόματα, μορφοποιούνται με διακριτικά σχεδίασης και συντάσσονται με την ίδια σύνταξη ετικετών όπως κάθε άλλο μπλοκ.

Το Blockstudio 7.3 περιλαμβάνει ένα πακέτο headless blocks UI, με την υποστήριξη του WordPress Interactivity API. Είναι καταχωρισμένα στον χώρο ονομάτων bsui/* και μπορούν να συνδυαστούν σε πρότυπα, σελίδες βασισμένες σε αρχεία, μοτίβα και περιεχόμενο αναρτήσεων.

Σημείωση

Τα στοιχεία UI βρίσκονται σε beta, καθώς συλλέγουμε σχόλια για τη συλλογή στοιχείων, την ονοματολογία, τη συμπεριφορά και τα μοτίβα χρήσης στα έργα. Μπορείτε να τα δοκιμάσετε στην έκδοση 7.3, αλλά το περιβάλλον API ενδέχεται να βελτιωθεί περαιτέρω προτού χαρακτηριστεί σταθερό.

Ενεργοποίηση στοιχείων UI

Τα ενσωματωμένα στοιχεία UI είναι προαιρετικά. Ενεργοποιήστε τα στο blockstudio.json του θέματός σας:

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

Ή ενεργοποιήστε τα με ένα φίλτρο:

PHP
add_filter('blockstudio/settings/ui/enabled', '__return_true');

Όταν ενεργοποιηθεί, το Blockstudio καταχωρίζει την ενσωματωμένη βιβλιοθήκη στοιχείων από το includes/ui/blocks.

Δημόσιος κατάλογος και παραδείγματα

Τα ενσωματωμένα block υλοποίησης παραμένουν κανονικές καταχωρίσεις bsui/*, αλλά όσοι τα χρησιμοποιούν θα πρέπει να αξιοποιούν τον δημόσιο κατάλογο οικογενειών στοιχείων κατά τη δημιουργία μιας συλλογής στοιχείων:

PHP
use Blockstudio\Ui;

$families = Ui::inventory();
$examples = Ui::examples();

Το Ui::inventory() ομαδοποιεί κάθε σύνθετο στοιχείο κάτω από τη δημόσια ρίζα του και παραθέτει τις καταχωρίσεις υλοποίησης που απαιτούνται από αυτήν την οικογένεια. Το Ui::examples() προσθέτει μια ντετερμινιστική, κανονικοποιημένη δήλωση με προεπιλεγμένα και ενδεικτικά δεδομένα. Διατηρεί τις απαιτούμενες σχέσεις ρίζας και θυγατρικών, ώστε το αποτέλεσμα να μπορεί να δοθεί απευθείας στο Blockstudio\Render::document().

Ο δημόσιος κατάλογος Canvas διαθέτει αυτά τα παραδείγματα στον τύπο ui και παραλείπει τις καταχωρίσεις ενσωματωμένης υλοποίησης από τον κανονικό τύπο blocks. Έτσι προκύπτει ένα ολοκληρωμένο παράδειγμα για κάθε δημόσια οικογένεια στοιχείων, αντί για μια συλλογή εσωτερικών αποσπασμάτων ρίζας, στοιχείου ενεργοποίησης, popup και επιπέδου.

Κατά τη συναρμολόγηση ενός εγγράφου που έχει ήδη αποδοθεί, το Ui::global_assets($block_names, $html) επιστρέφει το ακριβές ενσωματωμένο καθολικό στυλ και script μόνο όταν το επιλεγμένο αποτέλεσμα χρησιμοποιεί πράγματι ένα στοιχείο UI.

Απόδοση

Χρησιμοποιήστε τη συνήθη σύνταξη ετικετών block:

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

Λειτουργεί επίσης και η συντομότερη σύνταξη <bs:>:

HTML
<bs:bsui-button label="Save" variant="default" />

Στα πρότυπα Blockstudio, οι ετικέτες block αποδίδονται αυτόματα. Στις σελίδες και στα μοτίβα που βασίζονται σε αρχεία, συγχρονίζονται ως εγγενή blocks WordPress. Αν θέλετε να αποδίδετε στοιχεία UI απευθείας από περιεχόμενο αναρτήσεων ή περιοχές widget, ενεργοποιήστε τις ετικέτες block σε επίπεδο σελίδας:

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

Βασικά στοιχεία

Τα απλά στοιχεία αποδίδονται ως ένα block:

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>

Τα χαρακτηριστικά αντιστοιχούν απευθείας στα χαρακτηριστικά block.json κάθε στοιχείου. Για παράδειγμα, το bsui/button υποστηρίζει τα label, icon, iconPosition, href, variant, size και disabled.

PHP
bs_render_block([
  'name' => 'bsui/button',
  'data' => [
    'label' => 'Continue',
    'icon' => [
      'set' => 'heroicons',
      'subSet' => 'outline',
      'icon' => 'arrow-right',
    ],
    'iconPosition' => 'right',
  ],
]);

Σύνθετα στοιχεία

Πολλά στοιχεία UI αποτελούνται από σύνθετα blocks. Το block ρίζας διαχειρίζεται την κατάσταση, ενώ τα θυγατρικά blocks δηλώνουν το γονικό τους στοιχείο.

Καρτέλες

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>

Διάλογος

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>

Πεδίο επιλογής

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>

Πεδία φόρμας

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>

Διαθέσιμα blocks

Η ενσωματωμένη βιβλιοθήκη UI περιλαμβάνει:

Περιοχή Blocks
Διάταξη bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table
Ενέργειες bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar
Είσοδοι 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
Επικαλύψεις bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip
Πλοήγηση bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs
Σχόλια bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast
Φόρμες bsui/field, bsui/field-group, bsui/form

Τα σύνθετα στοιχεία διαθέτουν επίσης θυγατρικά blocks, όπως τα bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup και bsui/select-option.

Μορφοποίηση

Τα στοιχεία UI διαθέτουν τις δικές τους προσαρμοσμένες ιδιότητες CSS με το πρόθεμα --bs-ui-*. Μπορείτε να τις αντικαταστήσετε από το CSS του θέματός σας:

CSS
:root {
  --bs-ui-radius: 0.5rem;
  --bs-ui-primary: oklch(0.45 0.18 260);
  --bs-ui-primary-foreground: white;
}

Η συμπεριφορά των στοιχείων είναι headless, αλλά διαθέτουν αρκετά καθορισμένες προεπιλογές ώστε να μπορούν να χρησιμοποιηθούν αμέσως. Αντικαταστήστε πρώτα τα tokens και, όπου χρειάζεται, προσθέστε εξειδικευμένες ιδιότητες CSS για κάθε στοιχείο.

Το CSS των ενσωματωμένων στοιχείων εκπέμπεται στο επώνυμο επίπεδο cascade bsui. Το CSS του θέματος που δεν ανήκει σε επίπεδο μπορεί να παρακάμψει τους κανόνες των στοιχείων χωρίς !important:

CSS
.button-brand {
  background: var(--brand-primary);
}

Για να προσθέσετε μια προσαρμοσμένη παραλλαγή bsui/button, προσθέστε την επιλογή στο πεδίο επιλογής με το υπάρχον φίλτρο χαρακτηριστικών και δώστε στην παραλλαγή CSS το 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;
}';
});

Όλα τα στοιχεία

Πτυσσόμενες ενότητες Στοιβαγμένες ενότητες που ανοίγουν ένα πλαίσιο κάθε φορά. Διάλογος ειδοποίησης Ένα παράθυρο διαλόγου που διακόπτει τη ροή και απαιτεί απάντηση πριν κλείσει. Αναλογία διαστάσεων Κλειδώνει το περιεχόμενο σε σταθερή αναλογία πλάτους προς ύψος. Άβαταρ Μια εικόνα χρήστη που εμφανίζει τα αρχικά αν αποτύχει η φόρτωσή της. Ένδειξη Μια μικρή ετικέτα για κατάσταση, πλήθος και κατηγορίες. Διαδρομή πλοήγησης Δείχνει τη θέση της τρέχουσας σελίδας στην ιεραρχία. Κουμπί Εκτελεί μια ενέργεια, με παραλλαγές για κάθε επίπεδο έμφασης. Ομάδα κουμπιών Ενώνει σχετικά κουμπιά σε ένα ενιαίο τμηματικό στοιχείο ελέγχου. Ημερολόγιο Πλέγμα ημερολογίου για επιλογή μίας ημέρας. Κάρτα Μια επιφάνεια που ομαδοποιεί κεφαλίδα, σώμα και υποσέλιδο. Καρουζέλ Μια διαδρομή διαφανειών με δυνατότητα σάρωσης και υποστήριξη πληκτρολογίου. Πλαίσιο ελέγχου Δυαδική επιλογή που υποστηρίζει επίσης ακαθόριστη κατάσταση. Συμπτυσσόμενο Αποκρύπτει και εμφανίζει μία περιοχή περιεχομένου. Επιλογέας χρώματος Επιλέγει ένα χρώμα και το υποβάλλει μαζί με την περιβάλλουσα φόρμα. Συνδυαστικό πλαίσιο Πεδίο κειμένου που φιλτράρει μια λίστα επιλογών καθώς πληκτρολογείτε. Μενού περιβάλλοντος Ενέργειες που εμφανίζονται με δεξί κλικ και αγκυρώνονται στον δείκτη. Εισαγωγή ημερομηνίας Πεδίο με μάσκα για πληκτρολόγηση ημερομηνιών χωρίς επιλογέα. Διάλογος Επίπεδο παραθύρου διαλόγου για εργασίες που απαιτούν συγκέντρωση και επιβεβαιώσεις. Συρόμενο πλαίσιο Ένα πλαίσιο που ολισθαίνει από οποιαδήποτε άκρη της οθόνης. Πεδίο Περιβάλλει ένα στοιχείο ελέγχου με την ετικέτα, την περιγραφή και το μήνυμα σφάλματός του. Ομάδα πεδίων Ομαδοποιεί σχετικά πεδία κάτω από έναν κοινό τίτλο. Μεταφόρτωση αρχείου Περιοχή απόθεσης και επιλογέας αρχείων με υποστήριξη πολλών αρχείων. Φόρμα Υποβάλλει τα πεδία του και αναφέρει επιτυχία χωρίς επαναφόρτωση. Είσοδος Πεδίο κειμένου μίας γραμμής για όλους τους συνήθεις τύπους εισόδου. Συντόμευση πληκτρολογίου Εμφανίζει μια συντόμευση πληκτρολογίου στο δικό της πλήκτρο. Ετικέτα Λεζάντα για ένα στοιχείο ελέγχου, κοινή για κάθε στοιχείο με ετικέτα. Μενού Αναπτυσσόμενη λίστα ενεργειών αγκυρωμένη σε ένα στοιχείο ενεργοποίησης. Γραμμή μενού Οριζόντια γραμμή μενού, όπως σε μια εφαρμογή υπολογιστή. Μετρητής Εμφανίζει μια μέτρηση μέσα σε ένα γνωστό εύρος. Μενού πλοήγησης Πλοήγηση ιστότοπου με ένθετους συνδέσμους και πλαίσια που εμφανίζονται κατά την αιώρηση. Πεδίο αριθμού Αριθμητικό πεδίο εισόδου με βηματικά κουμπιά και περιορισμένο εύρος. Εισαγωγή OTP Διαχωρισμένα πλαίσια για την εισαγωγή κωδικού μίας χρήσης. Σελιδοποίηση Σύνδεσμοι σελίδων με προηγούμενη, επόμενη και αποσιωπητικά. Πεδίο κωδικού πρόσβασης Πεδίο κωδικού πρόσβασης με διακόπτη εμφάνισης. Πεδίο τηλεφώνου Πεδίο τηλεφώνου με επιλογή χώρας και μορφοποίηση. Αναδυόμενο πλαίσιο Πλούσιο περιεχόμενο αγκυρωμένο σε στοιχείο ενεργοποίησης, που κλείνει με κλικ εκτός αυτού. Κάρτα προεπισκόπησης Κάρτα προεπισκόπησης κατά την αιώρηση που δείχνει πού οδηγεί ένας σύνδεσμος. Πρόοδος Δείχνει την πρόοδο μιας εργασίας. Ομάδα κουμπιών επιλογής Ένα σύνολο επιλογών από τις οποίες μπορεί να επιλεγεί ακριβώς μία. Αξιολόγηση Στοιχείο ελέγχου με αστέρια για καταχώριση βαθμολογίας. Περιοχή κύλισης Κοντέινερ κύλισης με διαμορφωμένες γραμμές κύλισης επικάλυψης. Επιλέξτε Αναπτυσσόμενη λίστα για επιλογή από μια λίστα επιλογών. Διαχωριστικό Μια γραμμή που διαχωρίζει περιεχόμενο ή ομάδες στοιχείων ελέγχου. Σκελετός Σχήμα κράτησης θέσης που εμφανίζεται όσο φορτώνεται το περιεχόμενο. Ρυθμιστικό Επιλογή τιμής ή εύρους με σύρσιμο κατά μήκος μιας διαδρομής. Διάστημα Σταθερό βήμα κάθετου ρυθμού από την κλίμακα διαστημάτων. Περιστρεφόμενη ένδειξη Υποδεικνύει εργασία σε εξέλιξη χωρίς γνωστή διάρκεια. Στοίβα Τοποθετεί τα θυγατρικά στοιχεία σε γραμμή ή στήλη με σταθερά διαστήματα. Διακόπτης Εναλλάσσει μια ρύθμιση που εφαρμόζεται αμέσως. Πίνακας Δεδομένα σε μορφή πίνακα με προαιρετική ταξινόμηση και εναλλασσόμενη σκίαση γραμμών. Καρτέλες Εναλλάσσει μεταξύ πλαισίων που καταλαμβάνουν τον ίδιο χώρο. Text Αποδίδει πεζό κείμενο σε επιλεγμένο μέγεθος και σημασιολογική ετικέτα. Πεδίο κειμένου πολλών γραμμών Πεδίο κειμένου πολλών γραμμών που μεγαλώνει ανάλογα με τις γραμμές του. Επιλογέας ώρας Επιλέγει ώρα της ημέρας με επιλεγμένο βήμα. Πάροχος ειδοποιήσεων toast Φιλοξενεί προσωρινές ειδοποιήσεις σε μια γωνία της οθόνης. Εναλλαγή Κουμπί που παραμένει πατημένο για να αναπαριστά ενεργή κατάσταση. Ομάδα εναλλαγής Σύνολο διακοπτών που λειτουργούν ως επιλογή μίας ή πολλών τιμών. Γραμμή εργαλείων Σειρά στοιχείων ελέγχου με μετακινούμενη εστίαση μεταξύ τους. Επεξήγηση Μια σύντομη υπόδειξη που εμφανίζεται κατά την αιώρηση ή την εστίαση.