JavaScript контроллера использует переменные и свойства, определенные в глобальном объекте SCS, для отображения веб-страницы. Перед включением файла controller.js необходимо определить глобальный объект JavaScript в файле контроллера. В объекте SCS имеются два основных свойства, которые можно использовать для настройки:
Переменная SCS.sitePrefix
определяет префикс пути для сайта, находящегося в режиме онлайн. Обычно по умолчанию используется site/<siteName>/
.
JavaScript контроллера использует это значение для определения веб-страницы, которая будет отображаться. Например, если браузер запрашивает страницу в /site/SampleSite/products/index.html
, sitePrefix /site/SampleSite/
позволяет JavaScript вычислить, что на сайте должна отображаться страница products/index.html
. Обратите внимание, что sitePrefix должен быть строковым значением, которое начинается и заканчивается символом "/
".
/intranet/ExampleSite/
позволит доставлять веб-сайт с использованием такого пути в браузере вместо префикса пути по умолчанию /site/SampleSite/
.
Примечание.:
В качестве префикса sitePrefix в JavaScript контроллера по умолчанию используется "/
", если URL-адрес в браузере не совпадает с префиксом сайта. Это позволяет сайту работать с использованием персонализированного домена без индивидуальной настройки.Если это определено, перед выполнением какой-либо из вычислительных логических операций код JavaScript контроллера вызывает функцию SCS.preInitRendering
. Эта функция полезна для определения в пользовательских файлах контроллера. Она позволяет переопределить основные операции JavaScript контроллера.
Если это определено, SCS.preInitRendering
должна быть функцией. Она вызывается без каких-либо аргументов, и возвращаемое значение не ожидается и не обрабатывается.
Функция SCS.getDeviceInfo
позволяет настраивать логику обнаружения устройств внутри JavaScript контроллера. Это обнаружение используется для определения необходимости доставки мобильной или оперативной версии страницы.
Функция SCS.getDeviceInfo
не принимает никаких аргументов и возвращает объект JavaScript с двумя свойствами:
isMobile — логическое свойство, указывающее, что текущее устройство является мобильным клиентом, например смартфоном.
isIOS — логическое свойство, указывающее, что текущее устройство работает под управлением операционной системы на базе iOS.
Если пользовательский контроллер не переопределяет SCS.getDeviceInfo
, используется встроенная реализация по умолчанию.