Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

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.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Μη φορτώνετε από host ανάπτυξης στην παραγωγή

Το tag script παραπάνω δείχνει σε host ανάπτυξης, χρήσιμο για να δοκιμάσετε το Slim τοπικά. Μια αναπτυγμένη σελίδα πρέπει να φορτώνει το @xuda.io/xuda-runtime-slim-es, ή να σερβίρει το bundle από τον δικό σας τομέα εφαρμογής στο /cdn.

Ο constructor

js
new xuda(element?, options?, callback?)
new xuda.xuda(element?, options?, callback?)

Τα ορίσματα αντιστοιχίζονται με βάση τον τύπο, όχι τη θέση: ένα στοιχείο, ένα αντικείμενο επιλογών και ένα callback μπορούν να δοθούν με οποιαδήποτε σειρά.

  • element: το στοιχείο DOM στο οποίο γίνεται η προσάρτηση. Προαιρετικό στο Slim: αν το παραλείψετε, το περιβάλλον εκτέλεσης επιστρέφει στο document.body και καταγράφει μια προειδοποίηση αντί να αποτύχει.
  • options: επιλογές συνεδρίας και περιβάλλοντος εκτέλεσης, που καλύπτονται παρακάτω.
  • callback: καλείται ως callback('xuda_ready', SESSION_ID, SESSION_OBJ) μόλις η εφαρμογή είναι έτοιμη.

Για την ολοκλήρωση της προσάρτησης, το πιο αξιόπιστο hook είναι το συμβάν on_mounted στο document.body:

js
document.body.addEventListener('on_mounted', () => {
  console.log('Slim page mounted');
}, { once: true });

Συνηθισμένες επιλογές

Κάθε επιλογή παρακάτω επιλύεται μέσω της ίδιας αλυσίδας έξι βημάτων: πρώτα μια παράμετρος ερωτήματος 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).