Tietoja SCS-objektista

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

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.

Jos käytössä on välityspalvelin tai muu järjestelmä, kuten Akamai, ja URL-määritys, sivuston etuliitettä voidaan mukauttaa muokkaamalla tätä muuttujaa. Jos esimerkiksi sitePrefix-arvoksi määritetään /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.

SCS.preInitRendering

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

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.