Καταχώριση asset
Το Blockstudio προσθέτει αυτόματα στην ουρά όλα τα αρχεία που τελειώνουν σε .css, .scss και .js όταν χρησιμοποιείται το μπλοκ σας σε μια σελίδα. Μπορείτε να ορίσετε τον τρόπο προσθήκης των asset στην ουρά χρησιμοποιώντας ένα από τα ακόλουθα ονόματα αρχείων. Το * είναι χαρακτήρας υποκατάστασης που μπορεί να αντικατασταθεί με οποιαδήποτε συμβολοσειρά επιλέξετε.
Μέσα στα αρχεία μπλοκ CSS και SCSS, το %selector% αντικαθίσταται από την κλάση περιβλήματος του μπλοκ, η οποία περιορίζεται στο συγκεκριμένο μπλοκ. Έτσι μπορείτε να επιλέξετε το ίδιο στοιχείο που λαμβάνει το bs_get_scoped_class(), ακόμη κι όταν το αρχείο δεν είναι asset με περιορισμένη εμβέλεια.
| Μοτίβο | Συμπεριφορά |
|---|---|
*.(s)css |
Προστίθεται στην ουρά ως ετικέτα <link> στον επεξεργαστή και στο frontend |
*.inline.(s)css |
Το περιεχόμενο προστίθεται σε ενσωματωμένη ετικέτα <style> στον επεξεργαστή και στο frontend |
*.editor.(s)css |
Προστίθεται στην ουρά ως ετικέτα <link> μόνο στον επεξεργαστή |
*.scoped.(s)css |
Το περιεχόμενο με περιορισμένη εμβέλεια προστίθεται σε ενσωματωμένη ετικέτα <style> στον επεξεργαστή και στο frontend |
*.js |
Προστίθεται στην ουρά ως ετικέτα <script> στον επεξεργαστή και στο frontend |
*.inline.js |
Το περιεχόμενο προστίθεται σε ενσωματωμένη ετικέτα <script> στον επεξεργαστή και στο frontend |
*.editor.js |
Προστίθεται στην ουρά ως ετικέτα <script> μόνο στον επεξεργαστή |
*.view.js |
Προστίθεται στην ουρά ως ετικέτα <script> μόνο στο frontend |
Σημείωση
Η σημειογραφία με παύλα (
*-inline.css,*-editor.cssκ.λπ.) εξακολουθεί να υποστηρίζεται για λόγους συμβατότητας με παλαιότερες εκδόσεις, αλλά είναι παρωχημένη. Χρησιμοποιήστε τη σημειογραφία με τελεία στα νέα μπλοκ.
Ενσωματωμένα
Τα ενσωματωμένα στυλ και σκριπτ έχουν το σημαντικό πλεονέκτημα ότι αποδίδονται απευθείας ως ετικέτες style ή script μέσα στη σελίδα. Αυτό μπορεί να επιταχύνει τη φόρτωση, καθώς αποφεύγονται επιπλέον αιτήματα που διαφορετικά θα απαιτούνταν.
- Τα αρχεία
.jsενσωματώνονται στο τέλος του body - Τα αρχεία
.(s)cssενσωματώνονται στο τέλος του head - Κάθε αρχείο ενσωματώνεται μόνο μία φορά
Ενσωμάτωση μικρών stylesheet
Από προεπιλογή, ένα αρχείο *.(s)css συνδέεται, γεγονός που κοστίζει ένα αίτημα ανά αρχείο. Η ρύθμιση assets.inlineLimit εκτυπώνει τα μικρά stylesheet ενσωματωμένα, ακολουθώντας τον κανόνα που εφαρμόζει το WordPress στα δικά του στυλ: τα εξωτερικά stylesheet block μιας σελίδας ταξινομούνται από το μικρότερο στο μεγαλύτερο και εκτυπώνονται ως <style> όσο το αθροιστικό μέγεθός τους παραμένει εντός του ορίου. Κάθε άλλο αρχείο διατηρεί την ετικέτα <link>.
{
"assets": {
"inlineLimit": 40000
}
}
Το όριο μετριέται σε byte και το 0, που είναι η προεπιλογή, απενεργοποιεί αυτή τη συμπεριφορά. Μετρά το μεταγλωττισμένο αρχείο που θα φόρτωνε το <link>, σε ελαχιστοποιημένη μορφή όταν είναι ενεργό το assets.minify.css. Μόνο η επιλογή μεταξύ <link> και <style> εξαρτάται από το μέγεθος. Κάθε ετικέτα παραμένει εκεί όπου θα βρισκόταν το <link>, επομένως η σειρά φόρτωσης και η διαδοχή των στυλ παραμένουν αμετάβλητες. Το στοιχείο διατηρεί το id του.
Η ρύθμιση δεν εφαρμόζεται σε αρχεία *.inline.(s)css και *.scoped.(s)css, τα οποία είναι πάντα ενσωματωμένα, ούτε σε στοιχεία επεξεργαστή και διαχειριστικού περιβάλλοντος ή σε stylesheet που εξάγονται από εισαγόμενα module JavaScript. Τα καθολικά stylesheet προσμετρώνται όπως τα stylesheet block. Ένα αρχείο παραμένει συνδεδεμένο κάθε φορά που η ενσωμάτωσή του θα το άλλαζε:
- Περιέχει ένα σχετικό URL στο
url()ή στο@import, το οποίο επιλύεται ως προς το stylesheet όταν είναι συνδεδεμένο και ως προς τη σελίδα όταν είναι ενσωματωμένο. Οι απόλυτες διαδρομές, τα πλήρη URL, τα URIdata:και τα τμήματα#είναι αποδεκτά. - Χρησιμοποιεί
image-set()ή περιέχει ακολουθία κλεισίματος</style. - Περιέχει διαφυγές CSS, αρχή σχολίου HTML ή δήλωση
@charset. Αυτά τα αρχεία παραμένουν συνδεδεμένα για λόγους ασφάλειας, ώστε να αποφευχθεί ο κίνδυνος αλλαγής του URL ή της ανάλυσης του εγγράφου.
Χρησιμοποιήστε το φίλτρο ρύθμισης για να αλλάξετε το όριο από PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Το ενσωματωμένο CSS γίνεται μέρος του HTML της σελίδας. Η κρυφή μνήμη της σελίδας πρέπει να εκκαθαριστεί μετά από αλλαγή stylesheet και το πρόγραμμα περιήγησης δεν μπορεί να αποθηκεύσει αυτά τα byte στην κρυφή μνήμη μεταξύ σελίδων, γι’ αυτό το όριο αφορά το σύνολο ανά σελίδα.
Περιορισμένη εμβέλεια
Τα στυλ με περιορισμένη εμβέλεια ενσωματώνονται επίσης, αλλά προστίθεται μπροστά τους ένα ID μοναδικό για κάθε μπλοκ. Χρησιμοποιήστε τη συνάρτηση bs_get_scoped_class για να προσθέσετε την κλάση στο πρότυπό σας.
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Scope me!</h1>
</section>
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Το παραπάνω θα έχει ως αποτέλεσμα το ακόλουθο στυλ με περιορισμένη εμβέλεια:
<style>
.bs-62df71e6cc9a {
--hero-gap: var(--wp--preset--spacing--space-10);
}
.bs-62df71e6cc9a.hero {
border-bottom: 1px solid currentColor;
}
.bs-62df71e6cc9a .hero__title {
color: red;
}
</style>
<section class="hero bs-62df71e6cc9a">
<h1 class="hero__title">Scope me!</h1>
</section>
Οι συνηθισμένοι επιλογείς μέσα σε αρχείο με περιορισμένη εμβέλεια εξακολουθούν να επιλέγουν τους απογόνους του περιβλήματος. Χρησιμοποιήστε το %selector% όταν θέλετε να μορφοποιήσετε το ίδιο το περίβλημα.
Καθολικά
Εκτός από τα asset που αφορούν συγκεκριμένα μπλοκ, μπορείτε επίσης να προσθέσετε καθολικά asset στην ουρά, τα οποία θα είναι διαθέσιμα σε όλες τις σελίδες, είτε περιλαμβάνουν μπλοκ είτε όχι. Για να προσθέσετε ένα καθολικό asset στην ουρά, προσθέστε το πρόθεμα global- στο όνομα του αρχείου. Μπορείτε να χρησιμοποιήσετε οποιαδήποτε από τις καταλήξεις (e.g. -inline) σε συνδυασμό.
Οι πιθανοί συνδυασμοί είναι:
global-styles.(s)cssglobal-styles.inline.(s)cssglobal-styles.editor.(s)cssglobal-styles.scoped.(s)cssglobal-scripts.jsglobal-scripts.inline.jsglobal-scripts.editor.jsglobal-scripts.view.js
Διαχείριση
Τα asset διαχείρισης προστίθενται στην ουρά μόνο στην περιοχή διαχείρισης WordPress. Το πρόθεμα admin- χρησιμοποιείται για τον ορισμό asset διαχείρισης.
admin-styles.(s)cssadmin-scripts.js
Επεξεργαστής μπλοκ
Τα asset του επεξεργαστή μπλοκ προστίθενται στην ουρά μόνο στον επεξεργαστή μπλοκ. Το πρόθεμα block-editor- χρησιμοποιείται για τον ορισμό τους.
block-editor-styles.(s)cssblock-editor-scripts.js
Σημείωση
Αν το WordPress απενεργοποιήσει το iframe του επεξεργαστή επειδή ένα μπλοκ στην πλευρά του πελάτη έχει καταχωριστεί με
apiVersionμικρότερο από 3, ο καμβάς του επεξεργαστή και το περιβάλλον διαχείρισης WordPress μοιράζονται το ίδιο έγγραφο. Καθολικά σκριπτ ή σκριπτ του επεξεργαστή που συνδέονται με ταwindow,document,body, συμβάντα τροχού ή την κύλιση του εγγράφου θα πρέπει να ελέγχουν αν πρόκειται γιαbody.block-editor-pageή να εξαιρούν περιοχές του επεξεργαστή WordPress, όπως οι.interface-complementary-areaκαι.interface-navigable-region.
Σειρά φόρτωσης
Στο frontend, όταν είναι ενεργοποιημένες η αυτόματη προσθήκη asset στην ουρά και η προσωρινή αποθήκευση εξόδου,
το Blockstudio προσθέτει τις ετικέτες CSS <link> και <style> των μπλοκ στη σελίδα που βρίσκεται στην προσωρινή μνήμη,
ακριβώς πριν από την ετικέτα κλεισίματος </head>, αντί να τις καταχωρίσει στο wp_enqueue_style(). Έτσι, το CSS των μπλοκ έρχεται μετά τα φύλλα στυλ που έχει ήδη εκτυπώσει το WordPress στην κεφαλίδα, συμπεριλαμβανομένων των στυλ θεμάτων και πρόσθετων που προστέθηκαν στην ουρά με το wp_enqueue_style(), ανεξάρτητα από την προτεραιότητα ή τις εξαρτήσεις τους. Τα asset διαχείρισης και block-editor- χρησιμοποιούν αντί γι’ αυτό το σύστημα προσθήκης στην ουρά του WordPress.
Για κανόνες με την ίδια σημασία, το ίδιο επίπεδο cascade και την ίδια ειδικότητα, υπερισχύει το stylesheet του block έναντι του stylesheet του θέματος. Για να το αλλάξετε, αυξήστε την ειδικότητα του κανόνα του θέματος ή προσθέστε το stylesheet του θέματος στο head Blockstudio που δημιουργεί με το φίλτρο blockstudio/render/head. Το περιεχόμενο που προστίθεται από το φίλτρο τοποθετείται μετά τα στοιχεία ενεργητικού του block. Αφαιρέστε επίσης το stylesheet από την ουρά στο WordPress, ώστε να μη φορτωθεί δύο φορές.
add_action('wp_enqueue_scripts', function() {
wp_dequeue_style('theme-overrides');
}, 100);
add_filter('blockstudio/render/head', function($head) {
return $head . '<link rel="stylesheet" href="' . esc_url(get_theme_file_uri('overrides.css')) . '">';
});
Το φίλτρο head εκτελείται μόνο όταν το Blockstudio κάνει buffer τη σελίδα. Η προσωρινή αποθήκευση είναι απενεργοποιημένη στην προεπισκόπηση του Customizer και όταν το blockstudio/buffer/enabled επιστρέφει false. Το bs_is_buffering() σάς ενημερώνει για την περίπτωσή σας, ώστε ένα θέμα να μπορεί να προσθέσει το stylesheet του μέσω του φίλτρου όταν η σελίδα αποθηκεύεται προσωρινά και να το προσθέσει στην ουρά με το WordPress διαφορετικά. Η απάντηση είναι διαθέσιμη από το wp_enqueue_scripts και έπειτα και είναι false πριν από το template_redirect.
add_action('wp_enqueue_scripts', function() {
$url = get_theme_file_uri('overrides.css');
if (bs_is_buffering()) {
add_filter('blockstudio/render/head', function($head) use ($url) {
return $head . '<link rel="stylesheet" href="' . esc_url($url) . '">';
});
return;
}
wp_enqueue_style('theme-overrides', $url);
});
Χρησιμοποιήστε το blockstudio/buffer/output αν χρειάζεται να αναδιατάξετε το τελικό έγγραφο με διαφορετικό τρόπο.
Απενεργοποίηση προσθήκης στην ουρά
Η αυτόματη προσθήκη asset στην ουρά μπορεί να απενεργοποιηθεί από τη ρύθμιση assets/enqueue. Αυτό είναι χρήσιμο αν θέλετε να διαχειρίζεστε μόνοι σας την προσθήκη όλων των asset στην ουρά.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Ανά μπλοκ
Όταν τα πρότυπα ενός μπλοκ δεν επιστρέφουν τίποτα, το Blockstudio δεν προσθέτει asset στην ουρά για το συγκεκριμένο μπλοκ. Αυτή η μέθοδος είναι χρήσιμη για την απενεργοποίηση της προσθήκης στην ουρά όταν πληρούται μια συγκεκριμένη συνθήκη.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}