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

Στοιχεία 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, δεν προσθέτει τίποτα στην ουρά και δεν ενεργοποιεί μεταγλώττιση.

PHP
$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() για να επιθεωρήσετε τους ορισμούς των καταχωρισμένων πεδίων.