A vezérlő JavaScript kódja a globális SCS objektumban definiált változókat és tulajdonságokat használ a weboldal megjelenítéséhez. A vezérlőfájlban a globális JavaScript objektumot a controller.js fájl felvétele előtt kell definiálni. Az SCS objektumban a következő elsődleges tulajdonságok használhatók a testreszabáshoz:
Az SCS.sitePrefix
változó az online webhely elérési útvonalának előtagját definiálja. Szokásos alapértelmezett értéke site/<webhelyNeve>/
.
A vezérlő JavaScript kódja ezt az értéket használja annak meghatározásához, hogy melyik weboldalt kell megjeleníteni. Ha például a böngésző a /site/SampleSite/products/index.html
oldalt kéri, a /site/SampleSite/
előtag lehetővé teszi a JavaScript számára annak kiszámítását, hogy a products/index.html
oldalt kell megjeleníteni a webhelyen. Ügyeljen arra, hogy a sitePrefix értékének olyan karakterláncnak kell lennie, amelynek elején és végén a "/
" karakter áll.
/intranet/ExampleSite/
értékre lehetővé teszi ennek az elérési útvonalnak megfelelő webhely kézbesítését az alapértelmezett /site/SampleSite/
útvonalelőtag helyett.
Megjegyzés:
Belsőleg az alapértelmezett vezérlő JavaScript kódja a "/
" karaktert használja a sitePrefix értékeként, ha a böngészőben lévő URL-cím nem egyezik meg a webhely előtagjával. Ez lehetővé teszi a webhely kiszolgálását személyes tartomány használatával testreszabás nélkül.Ha definiálva van, minden számítási logika végrehajtása előtt az SCS.preInitRendering
függvényt hívja a vezérlő JavaScript kódja. Ez az egyéni vezérlőfájlokban definiálható hasznos függvény a vezérlő JavaScript kódja alapvető műveleteinek felülbírálásához.
Ha definiálva van, az SCS.preInitRendering
csak függvény lehet. Hívása argumentumok nélkül történik, és a rendszer nem vár és nem dolgoz fel visszatérési értéket.
Az SCS.getDeviceInfo
függvény lehetővé teszi az eszközfelismerési logika testreszabását a vezérlő JavaScript kódján belül. Ez a művelet annak meghatározására szolgál, hogy az oldal mobil vagy reagáló változatát kell-e kézbesíteni.
Az SCS.getDeviceInfo
függvény hívása argumentumok nélkül történik, és két tulajdonsággal rendelkező JavaScript objektumot ad vissza:
isMobile – logikai tulajdonság annak jelzésére, hogy az aktuális eszköz mobilügyfél, például okostelefon.
isIOS– logikai tulajdonság annak jelzésére, hogy az aktuális eszközön iOS alapú operációs rendszer fut.
Ha az egyéni vezérlő nem írja felül az SCS.getDeviceInfo
függvényt, a beépített alapértelmezett megvalósítást használja a rendszer.