Στοιχεία
Το Blockstudio περιλαμβάνει 59 UI στοιχεία σε κάθε έκδοση. Εγγράφονται αυτόματα, μορφοποιούνται με διακριτικά σχεδίασης και συντάσσονται με την ίδια σύνταξη ετικετών όπως κάθε άλλο μπλοκ.
Το Blockstudio 7.3 περιλαμβάνει ένα πακέτο headless blocks UI, με την υποστήριξη του WordPress Interactivity API. Είναι καταχωρισμένα στον χώρο ονομάτων bsui/* και μπορούν να συνδυαστούν σε πρότυπα, σελίδες βασισμένες σε αρχεία, μοτίβα και περιεχόμενο αναρτήσεων.
Σημείωση
Τα στοιχεία UI βρίσκονται σε beta, καθώς συλλέγουμε σχόλια για τη συλλογή στοιχείων, την ονοματολογία, τη συμπεριφορά και τα μοτίβα χρήσης στα έργα. Μπορείτε να τα δοκιμάσετε στην έκδοση 7.3, αλλά το περιβάλλον API ενδέχεται να βελτιωθεί περαιτέρω προτού χαρακτηριστεί σταθερό.
Ενεργοποίηση στοιχείων UI
Τα ενσωματωμένα στοιχεία UI είναι προαιρετικά. Ενεργοποιήστε τα στο blockstudio.json του θέματός σας:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Ή ενεργοποιήστε τα με ένα φίλτρο:
add_filter('blockstudio/settings/ui/enabled', '__return_true');
Όταν ενεργοποιηθεί, το Blockstudio καταχωρίζει την ενσωματωμένη βιβλιοθήκη στοιχείων από το includes/ui/blocks.
Δημόσιος κατάλογος και παραδείγματα
Τα ενσωματωμένα block υλοποίησης παραμένουν κανονικές καταχωρίσεις bsui/*, αλλά όσοι τα χρησιμοποιούν θα πρέπει να αξιοποιούν τον δημόσιο κατάλογο οικογενειών στοιχείων κατά τη δημιουργία μιας συλλογής στοιχείων:
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:
<block name="bsui/button" label="Save" variant="default"></block>
Λειτουργεί επίσης και η συντομότερη σύνταξη <bs:>:
<bs:bsui-button label="Save" variant="default" />
Στα πρότυπα Blockstudio, οι ετικέτες block αποδίδονται αυτόματα. Στις σελίδες και στα μοτίβα που βασίζονται σε αρχεία, συγχρονίζονται ως εγγενή blocks WordPress. Αν θέλετε να αποδίδετε στοιχεία UI απευθείας από περιεχόμενο αναρτήσεων ή περιοχές widget, ενεργοποιήστε τις ετικέτες block σε επίπεδο σελίδας:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Βασικά στοιχεία
Τα απλά στοιχεία αποδίδονται ως ένα block:
<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.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
Σύνθετα στοιχεία
Πολλά στοιχεία UI αποτελούνται από σύνθετα blocks. Το block ρίζας διαχειρίζεται την κατάσταση, ενώ τα θυγατρικά blocks δηλώνουν το γονικό τους στοιχείο.
Καρτέλες
<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>
Διάλογος
<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>
Πεδίο επιλογής
<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>
Πεδία φόρμας
<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 του θέματός σας:
: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:
.button-brand {
background: var(--brand-primary);
}
Για να προσθέσετε μια προσαρμοσμένη παραλλαγή bsui/button, προσθέστε την επιλογή στο πεδίο επιλογής με το υπάρχον φίλτρο χαρακτηριστικών και δώστε στην παραλλαγή CSS το 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;
}';
});
Σχετικά
- UIΣύνθεση, συμπεριλαμβανομένων των ελεγχόμενων πεδίων, των καρτών πεδίων και των διαχωριστικών γραμμής εργαλείων
- Προγραμματιστική απόδοση
- Στοιχεία
- Διαδραστικότητα API