Η γλώσσα .xu
Η μορφή blocks στην οποία γράφεται κάθε αρχείο πηγαίου κώδικα .xu, και τα έντεκα δομικά στοιχεία από τα οποία αποτελείται ένα έργο.
Ένα αρχείο .xu είναι αρχείο blocks, όχι module JavaScript. Κάθε block είναι ένα ζήτημα, και τα
blocks αντικειμένων (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) αναλύονται ως
literals τύπου JSON5: κλειδιά χωρίς εισαγωγικά, πίνακες και ένθετα αντικείμενα είναι όλα δεκτά.
Έντεκα δομικά στοιχεία
Ο φάκελος όπου βρίσκεται ένα αρχείο πηγαίου κώδικα καθορίζει σε ποιο είδος μονάδας μεταγλωττίζεται. Μια καλή εφαρμογή Xu συνήθως διαβάζεται πιο καθαρά όταν κάθε ζήτημα έχει τη δική του μονάδα αντί για ένα αρχείο που κάνει τα πάντα.
Το App.xu είναι το μοναδικό δεσμευμένο αρχείο: είναι πάντα η βασική εφαρμογή και μεταγλωττίζεται πάντα στο αναγνωριστικό προγράμματος
app. Για ένα αρχείο component το αναγνωριστικό επιλύεται με τη σειρά από το meta.id, μετά το mount.id, μετά
το όνομα βάσης του ίδιου του αρχείου. Κάθε άλλος τύπος μονάδας δεν έχει block <mount>, οπότε το αναγνωριστικό του επιλύεται από
το meta.id και μετά από το όνομα βάσης του αρχείου. Για τους πόρους JSON5 η σειρά είναι id, μετά _id, μετά
όνομα βάσης. Διπλά αναγνωριστικά σε ένα έργο δεν επιτρέπονται.
Blocks ανά τύπο μονάδας
Το App.xu δεν χρειάζεται ποτέ block <mount>. Ένα συνηθισμένο στοιχείο χρειάζεται μόνο όταν θέλετε να
προσαρτηθεί απευθείας σε μια σελίδα HTML αντί να προσεγγίζεται μέσω <panel program="...">:
Η γλώσσα των templates
Μέσα στο <template>, ένα μικρό σύνολο φιλικών aliases μεταγλωττίζεται στο δικό του markup xu-* του περιβάλλοντος εκτέλεσης.
Ένα στοιχείο, από την αρχή μέχρι το τέλος
Το <script> μεταγλωττίζεται σε module προσάρτησης από την πλευρά του client: η προεπιλεγμένη εξαγωγή δέχεται ένα αντικείμενο context
και μπορεί να επιστρέψει μια συνάρτηση αποδέσμευσης που θα εκτελεστεί κατά την αποφόρτωση. Τα blocks <style> συγκεντρώνονται σε ένα
ενιαίο φύλλο στυλ στοιχείου που σερβίρεται.
Μορφή πηγής δεδομένων
Χρησιμοποιήστε την αναγνώσιμη μορφή wrapper μέσα στο <datasource lang="json5">. Το type είναι ένα από none, table,
array, json ή csv.
Μια πηγή δεδομένων τύπου πίνακα χρησιμοποιεί table, filter, sort, direction, realtime, limit, skip και
output. Μια πηγή τύπου array, JSON ή CSV χρησιμοποιεί source.field ή source.url. Για οποιοδήποτε κλειδί πηγής δεδομένων
που η μορφή wrapper δεν εκθέτει, περάστε σε mode="raw" και γράψτε τα ονόματα πεδίων που χρησιμοποιεί το ίδιο το έγγραφο
εκτέλεσης.
Τα άλλα δέκα blocks, σύντομα
Ονομασμένες, επαναχρησιμοποιήσιμες αναγνώσεις. Το data/get/LoadStudentClasses.xu συνδυάζει <params> (δηλωμένα πεδία in/out)
με ένα <datasource>, ώστε ένα στοιχείο να καλεί έναν φορτωτή με το όνομά του αντί να κατέχει το ίδιο
τις λεπτομέρειες του ερωτήματος.
Ονομασμένες εγγραφές. Το data/set/SaveStudentProfile.xu προσθέτει crudMode και allowCreate στο <meta>
μαζί με τα params και την πηγή δεδομένων, δίνοντας στην αποθήκευση ένα ορατό, ελέγξιμο σπίτι στον πηγαίο κώδικα.
Επεξεργασία εγγραφή προς εγγραφή. Το data/batch/RebuildClassRoster.xu εκτελεί ένα βήμα <events> όπως το
before_record για κάθε γραμμή που επιλύει το <datasource>.
Ένα block <response> μετατρέπει params, αποτελέσματα πηγής δεδομένων και συμβάντα σε ένα payload τύπου JSON:
Ένας ονομασμένος, επαναχρησιμοποιήσιμος μετασχηματισμός. Το <code> εκτελείται ως σώμα συνάρτησης πάνω στα δηλωμένα params in και
επιστρέφει την τιμή out:
Ένας επαναχρησιμοποιήσιμος ορισμός μηνύματος, που αναφέρεται από μια ροή εργασίας αντί να γράφεται απευθείας κάθε φορά:
Οι διαδρομές (routes) περιγράφουν πώς τα στοιχεία παρουσιάζονται ως πλοηγήσιμη εφαρμογή· δεν αντικαθιστούν τα ίδια τα στοιχεία.
Ένα πλήρες παράδειγμα
Το xuda-studant-app-example είναι ένα πλήρες δέντρο πηγαίου κώδικα που καλύπτει και τα έντεκα blocks: μια ροή σύνδεσης, ένα
dashboard με διαδρομές, οθόνες καταλόγου μαθητών, εργασιών και προφίλ, αναγνώσεις και εγγραφές με υποστήριξη πίνακα, και
στυλ Tailwind. Αποσυμπιέστε το με:
Όλα τα παραπάνω αφορούν τη διερμηνευόμενη διάλεκτο που μεταγλωττίζει το xuda-cli: blocks που αναλύονται κατά την αποθήκευση σε έγγραφα εκτέλεσης
progUi / progFields / progEvents, τα οποία διαβάζει ο renderer της πλατφόρμας που καθοδηγείται από εκφράσεις. Ένας ξεχωριστός, μη δημοσιευμένος
compiler (@xuda/compiler, που χρησιμοποιείται από το vite-plugin-xu) διαβάζει ένα στενότερο αρχείο .xu που αποτελείται μόνο από <template>, <script> και <style>, αγνοεί τα ονόματα blocks
που αναφέρονται παραπάνω, και εκπέμπει εκ των προτέρων ένα πραγματικό module ES αντί για έγγραφο JSON. Στοχεύει τον νεότερο
renderer βασισμένο σε signals στο @xuda/core, την ίδια μηχανή που η πλατφόρμα διανέμει ως
runtime/js/xuda_core.globals.js. Δείτε το vite-plugin-xu και το
@xuda/core για αυτόν τον δρόμο.