JavaScript řadiče používá k vykreslování webové stránky proměnné a vlastnosti definované v globálním objektu SCS. Globální objekt JavaScriptu musí být v souboru řadiče definován ještě před zařazením souboru controller.js. K přizpůsobení lze použít dvě primární vlastnosti objektu SCS:
Proměnná SCS.sitePrefix
definuje předponu cesty webu online. Obvykle se jedná o výchozí zápis site/<siteName>/
.
JavaScript používá tuto hodnotu k určení obsahu zobrazeného na webové stránce. Pokud například prohlížeč požaduje stránku na adrese /site/SampleSite/products/index.html
, hodnota sitePrefix /site/SampleSite/
umožňuje JavaScriptu určit, že má zobrazit stránku products/index.html
tohoto webu. Hodnota sitePrefix musí být řetězec, který začíná a končí znakem „/
“.
/intranet/ExampleSite/
umožňuje doručení webové stránky v prohlížeči s tímto názvem cesty a nikoliv s výchozí předponou cesty /site/SampleSite/
.
Poznámka:
Pokud adresa URL v prohlížeči neodpovídá předponě webu, použije JavaScript výchozího řadiče interně jako hodnotu sitePrefix hodnotu „/
“. Web je tak možné zpracovat pomocí jednoduché domény bez přizpůsobení.Je-li funkce SCS.preInitRendering
definovaná, je volána kódem JavaScript řadiče ještě před spuštěním veškeré jeho výpočetní logiky. Jedná se o užitečnou funkci, která umožňuje nadefinovat přepsání základních operací JavaScriptu ve vlastních souborech řadiče.
Je-li definována, musí být SCS.preInitRendering
funkce. Je volána bez argumentů a není očekávána ani zpracována žádná návratová hodnota.
Funkce SCS.getDeviceInfo
umožňuje přizpůsobení logiky detekce zařízení uvnitř JavaScriptu řadiče. Tato detekce zjišťuje, jestli má být doručena mobilní nebo responzivní verze stránky.
Funkce SCS.getDeviceInfo
nepřijímá žádné argumenty a vrací objekt JavaScriptu se dvěma vlastnostmi:
isMobile – Booleovská vlastnost udávající, že aktuální zařízení je mobilní klient, například chytrý telefon.
isIOS – Booleovská vlastnost udávající, že aktuální zařízení používá operační systém iOS.
Pokud vlastní řadič funkci SCS.getDeviceInfo
nepřepíše, použije se výchozí vestavěná implementace.