컨트롤러 JavaScript는 전역 SCS 객체에 정의된 변수 및 속성을 사용하여 웹 페이지를 렌더링합니다. 전역 JavaScript 객체는 controller.js 파일이 포함되기 전 컨트롤러 파일에 정의되어 있어야 합니다. SCS 객체에는 사용자정의에 사용할 수 있는 두 가지 기본 속성이 있습니다.
SCS.sitePrefix 변수는 온라인 사이트의 경로 접두어를 정의합니다. 일반적으로 기본값은 site/<siteName>/입니다.
컨트롤러 JavaScript는 이 값을 사용하여 표시할 웹 페이지를 결정합니다. 예를 들어, 브라우저가 /site/SampleSite/products/index.html에서 페이지를 요청하는 경우, sitePrefix /site/SampleSite/는 JavaScript가 사이트의 products/index.html 페이지를 표시해야 하는지 계산하도록 허용합니다. sitePrefix는 "/" 문자로 시작하고 끝나는 문자열 값이어야 합니다.
/intranet/ExampleSite/로 설정하면 기본 /site/SampleSite/ 경로 접두어 대신 브라우저에서 해당 경로 이름으로 웹 사이트를 제공할 수 있습니다.
주:
브라우저의 URL이 사이트 접두어와 일치하지 않으면 내부적으로 기본 컨트롤러 JavaScript가 "/"를 sitePrefix로 사용합니다. 이렇게 하면 사용자정의 없이 vanity 도메인을 사용하여 사이트를 제공할 수 있습니다.정의된 경우 계산 논리가 실행되기 전 컨트롤러 JavaScript 코드에서 SCS.preInitRendering 함수가 호출됩니다. 이것은 컨트롤러 JavaScript의 기본 작업을 무효화하도록 사용자정의 컨트롤러 파일에서 정의하는 데 유용한 함수입니다.
정의되었으면 SCS.preInitRendering이 함수여야 합니다. 이 함수는 인수 없이 호출되며, 반환 값이 요구되거나 처리되지 않습니다.
SCS.getDeviceInfo 함수는 컨트롤러 JavaScript 내의 장치 감지 논리의 사용자정의를 허용합니다. 이러한 감지는 페이지의 모바일 또는 반응형 버전을 제공해야 할지 여부를 결정하기 위해 사용됩니다.
SCS.getDeviceInfo 함수는 인수를 사용하지 않으며, 두 속성이 포함된 JavaScript 객체를 반환합니다.
isMobile—현재 장치가 스마트 폰과 같은 모바일 클라이언트임을 나타내는 부울 속성입니다.
isIOS—현재 장치가 iOS 기반 운영체제에서 실행되고 있음을 나타내는 부울 속성입니다.
사용자정의 컨트롤러가 SCS.getDeviceInfo를 무효화하지 않으면 내장된 기본 구현이 사용됩니다.