Ohjaimen JavaScript käyttää yleisessä SCS-objektissa määritettyjä muuttujia ja ominaisuuksia verkkosivun hahmonnukseen. Yleinen JavaScript-objekti on määritettävä ohjaintiedostossa ennen controller.js-tiedoston sisällytystä. SCS-objektissa on kaksi pääominaisuutta, joita voidaan käyttää mukautukseen:
SCS.sitePrefix
-muuttuja määrittää online-tilassa olevan sivuston polun etuliitteen. Tavallisesti sen oletusarvo on site/<siteName>/
.
Ohjaimen JavaScript määrittää tämän arvon avulla näytettävän verkkosivun. Jos esimerkiksi selain pyytää sivua osoitteessa /site/SampleSite/products/index.html
, sitePrefix-arvon /site/SampleSite/
avulla JavaScript voi laskea, että sivustosta näytetään sivu products/index.html
. Huomaa, että sitePrefix-arvon on oltava merkkijono, jonka alussa ja lopussa on /
-merkki.
/intranet/ExampleSite/
, sivusto toimitetaan selaimeen kyseisellä polun nimellä oletusarvoisen polun etuliitteen /site/SampleSite/
sijaan.
Huomautus::
Oletusarvoinen ohjaimen JavaScript käyttää sisäisessä järjestelmässä sitePrefix-arvoa "/
", jos selaimessa oleva URL ei vastaa sivuston etuliitettä. Näin sivusto voidaan tarjota käyttämällä vaihtoehtoista toimialuetta ilman mukautusta.Jos se on määritetty, ohjaimen JavaScript-koodi kutsuu SCS.preInitRendering
-toimintoa ennen kuin sen laskentalogiikkaa suoritetaan. Tämä toiminto on kätevä määrittää mukautetuissa ohjaintiedostoissa ohjaimen JavaScriptin perustoimintojen ohitusta varten.
Jos se on määritetty, SCS.preInitRendering
-määrityksen on oltava toiminto. Sitä kutsutaan ilman argumentteja, eikä palautusarvoa odoteta eikä käsitellä.
SCS.getDeviceInfo
-toiminnolla voidaan mukauttaa laitteiden tunnistuslogiikkaa ohjaimen JavaScriptissä. Tunnistuksen avulla määritetään, toimitetaanko sivun mobiiliversio tai responsiivinen versio.
SCS.getDeviceInfo
-toiminnossa ei voi käyttää argumentteja, ja se palauttaa JavaScript-objektin, jolla on kaksi ominaisuutta:
isMobile — Boolen ominaisuus, joka ilmaisee, että käytettävä laite on mobiililaite, kuten älypuhelin.
isIOS — Boolen ominaisuus, joka ilmaisee, että käytettävässä laitteessa on iOS-pohjainen käyttöjärjestelmä.
Jos mukautettu ohjain ei ohita SCS.getDeviceInfo
-toimintoa, käytetään sisäistä oletustoteutusta.