O objektu SCS

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:

SCS.sitePrefix

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 „/“.

Pokud se používá proxy nebo jiná infrastruktura, například Akamai a pravidla mapování URL, lze předponu webu přizpůsobit změnou této proměnné. Například nastavení proměnné sitePrefix na hodnotu /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í.

SCS.preInitRendering

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.

SCS.getDeviceInfo

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.