Denetleyici JavaScript'i, web sayfasını görüntülemek için global SCS nesnesinde tanımlı değişkenleri ve nitelikleri kullanır. controller.js dosyası eklenmeden önce denetleyici dosyasında global JavaScript nesnesi tanımlanmalıdır. SCS nesnesinde özelleştirme için kullanılabilecek iki ana nitelik vardır:
SCS.sitePrefix
değişkeni çevrimiçi sitenin dizin yolu önekini tanımlar. Normalde bu öndeğer olarak site/<siteName>/
değerine sahiptir.
Denetleyici JavaScript'i bu değeri kullanarak hangi web sayfasının görüntüleneceğini belirler. Örneğin, tarayıcı sayfayı /site/SampleSite/products/index.html
dizin yolunda isterse /site/SampleSite/
sitePrefix, JavaScript'in sitedeki products/index.html
sayfasının görüntülenmesi gerektiğini hesaplamasını sağlar. sitePrefix'in "/
" karakteri ile başlayan ve biten bir dize değeri olması gerektiğini unutmayın.
/intranet/ExampleSite/
ayarlandığında, web sitesinin /site/SampleSite/
dizin yolu öneki öndeğeri yerine tarayıcıda bu dizin yolu ile teslim edilmesini sağlar.
Not:
Tarayıcıdaki URL'nin site öneki ile eşleşmemesi durumunda denetleyici JavaScript öndeğeri, dahili olarak "/
" karakterini sitePrefix olarak kullanır. Bu, sitenin özelleştirme içermeyen bir gösterim etki alanı kullanılarak sunulmasına olanak tanır.SCS.preInitRendering
fonksiyonu tanımlanırsa herhangi bir hesaplama mantığı yürütülmeden önce denetleyici JavaScript kodu tarafından çağrılır. Bu, denetleyici JavaScript'inin temel işlemlerini geçersiz kılmak üzere özel denetleyici dosyaları tanımlamak için kullanışlı bir fonksiyondur.
SCS.preInitRendering
tanımlanırsa bir fonksiyon olmalıdır. Bağımsız değişken olmadan çağrılır ve dönüş değeri beklenmez veya işlenmez.
SCS.getDeviceInfo
fonksiyonu, denetleyici JavaScript'i içindeki cihaz algılama mantığının özelleştirilmesine olanak tanır. Bu algılama, bir sayfanın mobil veya ekran uyumlu bir sürümünün teslim edileceğini belirlemek için kullanılır.
SCS.getDeviceInfo
fonksiyonu hiçbir bağımsız değişken almaz ve iki nitelik içeren bir JavaScript Nesnesi döndürür:
isMobile - Geçerli cihazın akıllı telefon gibi bir mobil istemci olduğunu belirten Mantıksal niteliktir.
isIOS - Geçerli cihazın iOS tabanlı bir işletim sisteminde çalıştığını belirten Mantıksal niteliktir.
Özel denetleyici SCS.getDeviceInfo
fonksiyonunu geçersiz kılmazsa yerleşik uygulama öndeğeri kullanılır.