Το JavaScript ελεγκτή χρησιμοποιεί μεταβλητές και ιδιότητες που ορίζονται στο καθολικό αντικείμενο SCS για την απόδοση της ιστοσελίδας. Το καθολικό αντικείμενο JavaScript πρέπει να ορίζεται στο αρχείο ελεγκτή πριν από τη συμπερίληψη του αρχείου controller.js. Υπάρχουν δύο κύριες ιδιότητες στο αντικείμενο SCS που μπορούν να χρησιμοποιηθούν για προσαρμογή:
Η μεταβλητή SCS.sitePrefix
καθορίζει το πρόθεμα διαδρομής της ηλεκτρονικής τοποθεσίας. Συνήθως, αυτό ορίζεται από προεπιλογή σε site/<siteName>/
.
Το JavaScript ελεγκτή χρησιμοποιεί αυτήν την τιμή για να προσδιορίσει ποια ιστοσελίδα θα εμφανίζεται. Για παράδειγμα, αν το πρόγραμμα περιήγησης ζητά τη σελίδα στη διεύθυνση /site/SampleSite/products/index.html
, το sitePrefix /site/SampleSite/
επιτρέπει στο JavaScript να υπολογίσει ότι πρέπει να εμφανίζεται η σελίδα products/index.html
στην τοποθεσία. Σημειώστε ότι το sitePrefix πρέπει να είναι τιμή συμβολοσειράς που ξεκινά και λήγει με χαρακτήρα "/
".
/intranet/ExampleSite/
επιτρέπει στην τοποθεσία web να παραδοθεί με το εν λόγω όνομα διαδρομής στο πρόγραμμα περιήγησης αντί για το προεπιλεγμένο πρόθεμα διαδρομής /site/SampleSite/
.
Σημείωση:
Εσωτερικά, το προεπιλεγμένο JavaScript ελεγκτή χρησιμοποιεί "/
" ως sitePrefix αν η διεύθυνση τοποθεσίας στο πρόγραμμα περιήγησης δεν συμφωνεί με το πρόθεμα τοποθεσίας. Αυτό επιτρέπει στην τοποθεσία να εξυπηρετηθεί χρησιμοποιώντας ελκυστικό τομέα χωρίς προσαρμογή.Αν ορίζεται, η συνάρτηση SCS.preInitRendering
καλείται από τον κώδικα JavaScript ελεγκτή πριν από την εκτέλεση οποιασδήποτε υπολογιστικής λογικής. Αυτή είναι μια χρήσιμη συνάρτηση που μπορείτε να ορίσετε σε προσαρμοσμένα αρχεία ελεγκτή για να παρακάμψετε βασικές λειτουργίες του JavaScript του ελεγκτή.
Αν ορίζεται, το SCS.preInitRendering
πρέπει να είναι συνάρτηση. Καλείται χωρίς ορίσματα και δεν αναμένεται ούτε υποβάλλεται σε επεξεργασία τιμή επιστροφής.
Η συνάρτηση SCS.getDeviceInfo
επιτρέπει την προσαρμογή της λογικής εντοπισμού συσκευής εντός του ελεγκτή JavaScript. Αυτός ο εντοπισμός χρησιμοποιείται για να προσδιοριστεί εάν θα πρέπει να παραδοθεί μια έκδοση για κινητά ή μια έκδοση απόκρισης μιας σελίδας.
Η συνάρτηση SCS.getDeviceInfo
δεν δέχεται ορίσματα και επιστρέφει ένα αντικείμενο JavaScript με δύο ιδιότητες:
isMobile—μια ιδιότητα Boolean που υποδεικνύει ότι η τρέχουσα συσκευή είναι εφαρμογή-πελάτης για κινητά, όπως smartphone.
isIOS—μια ιδιότητα Boolean που υποδεικνύει ότι η τρέχουσα συσκευή εκτελείται σε λειτουργικό σύστημα βάσει iOS.
Αν ο προσαρμοσμένος ελεγκτής δεν παρακάμπτει το SCS.getDeviceInfo
, χρησιμοποιείται η ενσωματωμένη προεπιλεγμένη υλοποίηση.