Επεξεργασία asset
Ελαχιστοποίηση
Το Blockstudio μπορεί να ελαχιστοποιεί αυτόματα όλα τα αρχεία CSS και JS ενός μπλοκ.
Τα μεταγλωττισμένα αρχεία αποθηκεύονται στον φάκελο _dist του μπλοκ και προστίθενται στην ουρά όταν χρησιμοποιείται το μπλοκ. Όταν ενημερωθεί το αρχείο προέλευσης, το Blockstudio ελέγχει αν υπάρχει μεταγλωττισμένο αρχείο με την αντίστοιχη χρονική σήμανση· αν δεν υπάρχει, το δημιουργεί.
Για τον σκοπό αυτό χρησιμοποιείται η βιβλιοθήκη minify.
Η ελαχιστοποίηση ενεργοποιείται με τη ρύθμιση assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Αν προτιμάτε να γράφετε τα στυλ σας σε SCSS, μπορείτε να ενεργοποιήσετε την επεξεργασία SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Έτσι ενεργοποιείται η επεξεργασία SCSS για αρχεία .css.
Εναλλακτικά, μπορείτε να χρησιμοποιήσετε την επέκταση .scss, ώστε τα στυλ να υποβάλλονται αυτόματα σε επεξεργασία ακόμη κι όταν η παραπάνω ρύθμιση δεν είναι true.
Διαδρομές εισαγωγής
Με το SCSS, μπορείτε να εισάγετε και άλλα αρχεία SCSS. Οι διαδρομές των εισαγωγών είναι σχετικές με το αρχείο από το οποίο γίνεται η εισαγωγή.
@import "modules.scss";
Επιπλέον, μπορείτε να ορίσετε προσαρμοσμένες διαδρομές εισαγωγής με το φίλτρο blockstudio/assets/process/scss/import_paths, ώστε να εισάγετε αρχεία από άλλους καταλόγους χωρίς να καθορίζετε τη δομή των φακέλων.
Στις εισαγωγές μπορείτε να παραλείψετε την επέκταση .scss και να επιλύσετε μερικά αρχεία, όπως το _tokens.scss ή το _index.scss ενός καταλόγου.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Πρόλογος
Αν θέλετε κοινές συναρτήσεις, μεταβλητές, mixins ή βοηθητικά στοιχεία του Sass διαθέσιμα σε κάθε αρχείο SCSS, μπορείτε να προσθέσετε έναν καθολικό πρόλογο πριν από τη μεταγλώττιση.
Αυτό είναι χρήσιμο για πλαίσια όπως το Bootstrap, όπου μπορεί να θέλετε να έχετε πρόσβαση σε κοινά mixins, όπως τα σημεία διακοπής, χωρίς να επαναλαμβάνετε τις εισαγωγές σε κάθε asset μπλοκ.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Σε συνδυασμό με το blockstudio/assets/process/scss/import_paths, αυτό καθιστά διαθέσιμη την επιφάνεια Sass σε κάθε μεταγλωττισμένο αρχείο.
Τα asset των μπλοκ μεταγλωττίζονται ξανά όταν αλλάζει ο χρόνος τροποποίησης μιας εξάρτησης, συμπεριλαμβανομένων αρχείων που εισάγονται από άλλα μερικά αρχεία. Το Blockstudio παρακολουθεί τις τοπικές εξαρτήσεις @import, @use και @forward, συμπεριλαμβανομένων των εξαρτήσεων του προλόγου και των διαμορφωμένων διαδρομών εισαγωγής. Οι κοινές εξαρτήσεις παρακολουθούνται μία φορά και οι κύκλοι δεν προκαλούν ατέρμονη αναζήτηση. Αυτά τα αρχεία περιλαμβάνονται επίσης στη λίστα παρακολούθησης της κρυφής μνήμης εκτέλεσης.
Για παράδειγμα, αν επεξεργαστείτε το mixins/_wysiwyg.scss, το global-styles.scss μεταγλωττίζεται ξανά όταν εισάγει το scss/_wysiwyg.scss, το οποίο με τη σειρά του εισάγει αυτό το mixin. Δεν χρειάζεται να αγγίξετε το αρχείο εισόδου για να εφαρμοστούν οι αλλαγές. Οι ενσωματωμένες μονάδες του Sass και οι απομακρυσμένες εισαγωγές εξαιρούνται από το τοπικό γράφημα εξαρτήσεων.
Μονάδες ES
Όλα τα σκριπτ (ενσωματωμένα και προεπιλεγμένα) στο Blockstudio φορτώνονται με ενεργοποιημένο το type="module" από προεπιλογή. Έτσι, μπορείτε να χρησιμοποιήσετε τη σύνταξη import στα σκριπτ των μπλοκ σας χωρίς πρόσθετη ρύθμιση.
Σημείωση
Για μια πιο αναλυτική παρουσίαση των ES modules, επισκεφτείτε την τεκμηρίωση ιστού MDN.
Ας υποθέσουμε ότι ο ακόλουθος κώδικας βρίσκεται μέσα σε ένα script.js:
import { h, render } from "https://esm.sh/preact@10.15.1";
import htm from "https://esm.sh/htm@3.1.1";
import confetti from "https://esm.sh/canvas-confetti@1.6.0";
const html = htm.bind(h);
function App(props) {
confetti();
return html`<h1>Hello ${props.name}!</h1>`;
}
render(
html`<${App} name="Hello from Preact!" />`,
document.querySelector("#element")
);
Το παραπάνω παράδειγμα δημιουργεί ένα στοιχείο χρησιμοποιώντας το Preact και εισάγοντας όλα τα απαραίτητα στοιχεία και τις συναρτήσεις από ένα CDN συμβατό με ESM, στην προκειμένη περίπτωση το esm.sh. Αυτή η προσέγγιση δεν είναι λανθασμένη, αλλά απαιτεί τη φόρτωση των απαραίτητων asset από εξωτερικό ιστότοπο, με κίνδυνο να πάψουν να λειτουργούν τα σκριπτ αν ο CDN είναι εκτός λειτουργίας.
Το Blockstudio προσφέρει έναν εύχρηστο τρόπο λήψης ES Modules στο μπλοκ, εξαλείφοντας την ανάγκη για εξωτερικά CDN ESM στο περιβάλλον παραγωγής.
Ρύθμιση
Για να κατεβάσετε μια μονάδα στον κατάλογο του μπλοκ σας, χρησιμοποιήστε το πρόθεμα npm:, ακολουθούμενο από το όνομα και την έκδοση του πακέτου:
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";
Αυτή η σύνταξη ακολουθεί τη σύμβαση specifierDeno του npm.
Σημείωση
Το παλαιού τύπου πρόθεμα
blockstudio/(e.g.,blockstudio/preact@10.15.1) εξακολουθεί να υποστηρίζεται για λόγους συμβατότητας με παλαιότερες εκδόσεις, αλλά συνιστούμε να χρησιμοποιείτε το πρόθεμαnpm:σε νέα έργα. Για λεπτομέρειες, δείτε τον οδηγό μετάβασης.
Το Blockstudio ελέγχει αυτόματα τα τροποποιημένα αρχεία .js για εισαγωγές και τα κατεβάζει στον τοπικό κατάλογο του μπλοκ. Τα αρχεία που κατεβαίνουν τοποθετούνται σε φάκελο modules μέσα στον κατάλογο του μπλοκ.
Κατά την αποθήκευση, το αρχείο σκριπτ ξαναγράφεται ώστε να προσαρμοστεί στην τοπικά φιλοξενούμενη μονάδα:
import { h, render } from "./modules/preact/10.15.1.js";
import htm from "./modules/htm/10.15.1.js";
import confetti from "./modules/canvas-confetti/1.6.0.js";
Όταν βρίσκεστε στον επεξεργαστή και κάνετε προεπισκόπηση ή εργάζεστε στο μπλοκ, εξακολουθεί να χρησιμοποιείται το URL CDN (το Blockstudio χρησιμοποιεί το esm.sh).
Περιορισμοί
Έκδοση
Κανονικά, μπορείτε να χρησιμοποιήσετε μονάδες από CDN χωρίς αριθμό έκδοσης· σε αυτή την περίπτωση χρησιμοποιείται πάντα η πιο πρόσφατη έκδοση. Επειδή το Blockstudio δεν αποθηκεύει πληροφορίες στη βάση δεδομένων, απαιτείται αριθμός έκδοσης για τη χρήση μονάδων.
Ίδιες μονάδες
Οι μονάδες περιορίζονται στα μπλοκ τους. Ακόμη κι αν χρησιμοποιείτε την ίδια μονάδα με τον ίδιο αριθμό έκδοσης σε πολλά μπλοκ, το Blockstudio θα την κατεβάσει ξανά στο αντίστοιχο μπλοκ. Αυτό γίνεται κυρίως επειδή τα μπλοκ πρέπει να είναι αυτοτελείς μονάδες που μπορούν εύκολα να διαμοιραστούν σε άλλες εγκαταστάσεις ή ιστοτόπους.
Επιπλέον, η ίδια μονάδα θα ζητηθεί δύο φορές αν υπάρχουν και τα δύο μπλοκ στη σελίδα. Αυτό μπορεί να λυθεί χρησιμοποιώντας το script-inline.js αντί για το αρχείο script.js. Το Blockstudio ξαναγράφει κάθε εισαγωγή ώστε να δείχνει στη θέση της πρώτης εμφάνισης της μονάδας, εφόσον το όνομα και ο αριθμός έκδοσης είναι ίδια.
Φορτωτής CSS
Μπορείτε επίσης να εισάγετε αρχεία CSS χρησιμοποιώντας την ίδια σύνταξη με παραπάνω.
import "npm:swiper@11.0.0/swiper.min.css";
Το αρχείο CSS κατεβαίνει στον φάκελο modules και προστίθεται αυτόματα στην ουρά όταν χρησιμοποιείται το μπλοκ. Εφόσον η έκδοση είναι ίδια, προστίθεται στην ουρά μόνο μία έκδοση του αρχείου CSS, ακόμη κι αν υπάρχει σε πολλά μπλοκ.