Xuda Slim
Το ελαφρύ σημείο εισόδου του browser στο περιβάλλον εκτέλεσης του Xuda, χωρίς φορτωτή έργου.
Το Xuda Slim είναι η ελαφριά επιφάνεια συγγραφής και ενσωμάτωσης για το περιβάλλον εκτέλεσης του Xuda. Είναι χρήσιμο όταν θέλετε την αντιδραστική πηγή δεδομένων, τα directives, τα συμβάντα και τα δομικά tags του Xuda, χωρίς να ξεκινήσετε από το πλήρες σχήμα έργου του Xuda CLI.
Το Slim είναι πάντα Xuda, όχι ένα διαφορετικό περιβάλλον εκτέλεσης. Οι εκφράσεις εξακολουθούν να διαβάζουν πεδία με @field_name, το
περιβάλλον εκτέλεσης εξακολουθεί να δουλεύει με έγγραφα προγραμμάτων του Xuda, και δομικά tags όπως τα xu-single-view και
xu-panel εξακολουθούν να έχουν σημασία. Το <template> υποστηρίζεται, αλλά δεν απαιτείται.
Σε τι χρησιμεύει το Slim
- σελίδες HTML γραμμένες με το χέρι με αντιδραστικότητα Xuda
- επιδείξεις περιβάλλοντος εκτέλεσης και τεκμηρίωση
- ενσωματώσιμα widgets ή microsites
- παραγόμενα δέντρα εκτέλεσης
project_data - σταδιακή υιοθέτηση του Xuda χωρίς να εισαγάγετε πρώτα έναν πλήρη compiler πηγαίου κώδικα
Οι τρεις τρόποι συγγραφής
Οι τρόποι αυτοί μπορούν να συνδυαστούν: αν το Slim λάβει project_data και η σελίδα έχει επίσης tags <template>, τα
templates αναλύονται και προστίθενται στο project_data.programs μαζί με αυτό.
Φόρτωση του περιβάλλοντος εκτέλεσης
Ο υποστηριζόμενος τρόπος για να αποκτήσετε το bundle είναι το δημόσιο πακέτο npm @xuda.io/xuda-runtime-slim-es. Αν
έχετε μια αναπτυγμένη εφαρμογή Xuda, η πλατφόρμα σερβίρει επίσης το bundle εκτέλεσης από τον δικό σας τομέα εφαρμογής
στο /cdn, με μη συμπιεσμένη έκδοση στο /cdn/debug.
Το tag script παραπάνω δείχνει σε host ανάπτυξης, χρήσιμο για να δοκιμάσετε το Slim τοπικά. Μια αναπτυγμένη σελίδα
πρέπει να φορτώνει το @xuda.io/xuda-runtime-slim-es, ή να σερβίρει το bundle από τον δικό σας τομέα εφαρμογής στο /cdn.
Ο constructor
Τα ορίσματα αντιστοιχίζονται με βάση τον τύπο, όχι τη θέση: ένα στοιχείο, ένα αντικείμενο επιλογών και ένα callback μπορούν να δοθούν με οποιαδήποτε σειρά.
element: το στοιχείο DOM στο οποίο γίνεται η προσάρτηση. Προαιρετικό στο Slim: αν το παραλείψετε, το περιβάλλον εκτέλεσης επιστρέφει στοdocument.bodyκαι καταγράφει μια προειδοποίηση αντί να αποτύχει.options: επιλογές συνεδρίας και περιβάλλοντος εκτέλεσης, που καλύπτονται παρακάτω.callback: καλείται ωςcallback('xuda_ready', SESSION_ID, SESSION_OBJ)μόλις η εφαρμογή είναι έτοιμη.
Για την ολοκλήρωση της προσάρτησης, το πιο αξιόπιστο hook είναι το συμβάν on_mounted στο document.body:
Συνηθισμένες επιλογές
Κάθε επιλογή παρακάτω επιλύεται μέσω της ίδιας αλυσίδας έξι βημάτων: πρώτα μια παράμετρος ερωτήματος URL, μετά ένα
attribute στο ριζικό στοιχείο, μετά το options.params[key], μετά το options[key], μετά ένα cookie, μετά το
localStorage. Γι' αυτό μια σελίδα Slim μπορεί να αναδιαμορφωθεί από ένα query string χωρίς αλλαγή κώδικα.
Πώς καταλαβαίνετε ότι το Slim δουλεύει
- το bundle φορτώθηκε
- το
prog_idσας εμφανίζει κάτι ορατό - το συμβάν
on_mountedενεργοποιείται - το UI που καθοδηγείται από πεδία αρχίζει να συμπεριφέρεται αντιδραστικά
Αν συμβούν και τα τέσσερα, η σελίδα είναι σε καλή κατάσταση. Αν δεν εμφανίζεται τίποτα, ελέγξτε με τη σειρά: ότι το bundle
φορτώθηκε πραγματικά, ότι το prog_id ταιριάζει με πραγματικό id template ή κλειδί προγράμματος, ότι το πρόγραμμα υπάρχει στο
project_data.programs, και ότι ο στόχος προσάρτησης είναι πραγματικό στοιχείο (ή αφήνεται σκόπιμα στην
επιστροφή στο body).