Στοιχεία asset
Το Blockstudio παρέχει μια ροή επεξεργασίας asset χωρίς ρυθμίσεις για τα μπλοκ σας. Τοποθετήστε αρχεία CSS, SCSS ή JavaScript δίπλα στο μπλοκ σας και θα μεταγλωττιστούν, θα ελαχιστοποιηθούν και θα προστεθούν αυτόματα στην ουρά.
- Καταχώριση asset: Συμβάσεις ονοματοδοσίας αρχείων και συμπεριφορά προσθήκης στην ουρά
- Επεξεργασία: Μεταγλώττιση SCSS, εισαγωγές ES module και ελαχιστοποίηση
- Πεδίο κώδικα: Επεξεργασία κώδικα σε γραμμή μέσω του τύπου πεδίου κώδικα
Επιθεώρηση των στοιχείων ενός block
Το bs_block_assets('theme/card') επιστρέφει τα εντοπισμένα στοιχεία του frontend και του καμβά επεξεργασίας ενός καταχωρισμένου block Blockstudio. Καλέστε το μετά την καταχώριση του block, στο init ή σε μεταγενέστερη έκδοση. Άγνωστα block, block που δεν είναι Blockstudio και block χωρίς στοιχεία επιστρέφουν []. Η βοηθητική συνάρτηση δεν αποδίδει το block, δεν προσθέτει τίποτα στην ουρά και δεν ενεργοποιεί μεταγλώττιση.
$assets = bs_block_assets('theme/card');
// Each entry has this shape:
[
'type' => 'style',
'handle' => 'blockstudio-theme-card-style-css',
'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
'inline' => false,
'scope' => ['frontend', 'editor'],
'html' => '<link ...>',
];
- Το
typeείναιstyleγια CSS καιmoduleγια JavaScript. Τα στοιχεία JavaScript του Blockstudio που βασίζονται σε αρχεία χρησιμοποιούν ES modules, συμπεριλαμβανομένων των ενσωματωμένων script. - Το
handleείναι το σταθερό αναγνωριστικό στοιχείου που χρησιμοποιείται από την απόδοση του Blockstudio και το φίλτροblockstudio/assets/disable. Δεν χρειάζεται να προστεθεί στην ουρά του WordPress. - Το
urlείναι το επιλυμένο URL του υπάρχοντος μεταγλωττισμένου στοιχείου, μαζί με την έκδοσή του, ή το πηγαίο URL όταν δεν υπάρχει μεταγλωττισμένο αρχείο. Για ενσωματωμένα στοιχεία είναιnull. - Το
inlineδιακρίνει την ενσωματωμένη έξοδο<style>/<script>από τα εξωτερικά αρχεία. - Το
scopeπαραθέτει τα περιβάλλοντα στα οποία εφαρμόζεται το στοιχείο: ταfrontendκαιeditorγια κοινόχρηστα αρχεία, και μόνο ένα για αρχεία προβολής/επεξεργαστή. - Το
htmlπεριέχει την έτοιμη προς χρήση ετικέτα από την κανονική απόδοση στοιχείων. Το ενσωματωμένο περιεχόμενο, τα περιορισμένης εμβέλειας CSS, τα επίπεδα στυλ UI και τα φίλτρα απενεργοποίησης κατά την απόδοση διαχειρίζονται με τον ίδιο τρόπο όπως η συνηθισμένη έξοδος block.
Τα αρχεία SCSS που λείπουν, είναι κενά, απενεργοποιημένα ή δεν έχουν μεταγλωττιστεί παραλείπονται. Εξαιρούνται τα στοιχεία εγγράφου γονέα που προστίθενται στην ουρά από το WordPress για το διαχειριστικό περιβάλλον και τον επεξεργαστή block. Η λίστα περιορίζεται στα δικά του εντοπισμένα αρχεία του block. Δεν περιλαμβάνει ολόκληρο το γράφημα εξαρτήσεων: τα ένθετα block, οι τιμές πεδίων κώδικα, οι χειριστές που προστίθενται στην ουρά από το WordPress, οι εισαγωγές module CSS, τα Tailwind και οι κοινόχρηστοι χρόνοι εκτέλεσης UI/Interactivity ενδέχεται να εξαρτώνται από το περιεχόμενο που αποδίδεται. Χρησιμοποιήστε το Render::document() για μια πλήρη, αυτοτελή προεπισκόπηση. Χρησιμοποιήστε το bs_block_fields() για να επιθεωρήσετε τους ορισμούς των καταχωρισμένων πεδίων.