JavaScript คอนโทรลเลอร์ใช้ตัวแปรและคุณสมบัติที่กำหนดในออบเจกต์ SCS ร่วมเพื่อแสดงเว็บเพจ ต้องกำหนดออบเจกต์ JavaScript ในไฟล์คอนโทรลเลอร์ก่อนการรวมไฟล์ controller.js มีคุณสมบัติหลัก 2 คุณสมบัติในออบเจกต์ SCS ที่สามารถใช้สำหรับการปรับแต่ง:
ตัวแปร SCS.sitePrefix
กำหนดคำนำหน้าพาธของไซตืออนไลน์ ตามปกติค่าดีฟอลต์นี้จะกำหนดเป็น site/<siteName>/
JavaScript คอนโทรลเลอร์ใช้ค่านี้เพื่อกำหนดข้อมูลที่เว็บเพจจะแสดง ตัวอย่างเช่น หากเบราเซอร์ส่งคำขอเพจที่ /site/SampleSite/products/index.html
sitePrefix /site/SampleSite/
จะอนุญาตให้ JavaScript คำนวณว่าควรแสดงเพจ products/index.html
ในไซต์ โปรดทราบว่า sitePrefix ต้องเป็นค่าสตริงที่ขึ้นต้นและลงท้ายด้วยอักขระ "/
"
/intranet/ExampleSite/
จะอนุญาตให้ส่งเว็บไซต์ที่มีชื่อพาธนั้นในเบราเซอร์แทนคำนำหน้าพาธ /site/SampleSite/
ดีฟอลต์
หมายเหตุ:
JavaScript คอนโทรลเลอร์ดีฟอลต์ใช้ "/
" เป็น sitePrefix ภายในหาก URL ในเบราเซอร์ไม่ตรงกับคำนำหน้าไซต์ ซึ่งจะช่วยให้สามารถใช้ไซต์ได้โดยใช้โดเมนย่อโดยไม่มีการปรับแต่งหากกำหนดไว้ ระบบจะเรียกฟังก์ชัน SCS.preInitRendering
ตามรหัส JavaScript ของคอนโทรลเลอร์ก่อนตรรกะการคำนวณจะรัน ฟังก์ชันนี้มีประโยชน์ในการกำหนดไฟล์คอนโทรลเลอร์ที่กำหนดเองเพื่อแก้ไขการดำเนินการพื้นฐานของ JavaScript คอนโทรลเลอร์
หากกำหนดไว้ SCS.preInitRendering
ต้องเป็นฟังก์ชัน ระบบจะเรียกโดยไม่มีอาร์กิวเมนต์ และไม่มีการคาดหมายหรือประมวลผลค่าผลลัพธ์
ฟังก์ชัน SCS.getDeviceInfo
อนุญาตให้ปรับแต่งตรรกะการตรวจพบอุปกรณ์ภายใน JavaScript คอนโทรลเลอร์ การตรวจพบนี้ใช้เพื่อกำหนดว่าควรส่งอุปกรณ์เคลื่อนที่หรือเวอร์ชันเพจที่ตอบสนองหรือไม่
ฟังก์ชัน SCS.getDeviceInfo
ไม่ได้ใช้อาร์กิวเมนต์ใดๆ และแสดงออบเจกต์ JavaScript ที่มี 2 คุณสมบัติดังนี้:
isMobile—คุณสมบัติบูลีนระบุว่าอุปกรณ์ปัจจุบันเป็นโมบายไคลเอนต์ เช่น สมาร์ทโฟน
isIOS—คุณสมบัติบูลีนระบุว่าอุปกรณ์ปัจจุบันรันอยู่ในระบบปฏิบัติการ iOS
หากคอนโทรลเลอร์ที่กำหนดเองไม่ได้แก้ไข SCS.getDeviceInfo
ระบบจะใช้การนำไปใช้ดีฟอลต์ภายใน