Et sitehierarki gemmes i filen structure.json
, der er knyttet til sitet. Hierarkiet indlæses i hukommelsen og gøres tilgængeligt i sidekonteksten som objektet SCS.structureMap
.
Site Builder læser filen structure.json
for at tegne sitetræet i Site Builder. Filen structure.json
indeholder koden for sitesiderne. Eksempel:
"pages": [ { "id": 100, "name": "Home", "parentId": null, "pageUrl": "index.html", "hideInNavigation": false, "linkUrl": "", "linkTarget": "", "children": [ 200, 300, 400, 500 ], "overrideUrl":false } { "id":200, "name":"Products" "parentId":100, "hideInNavigation":false, "LinkUrl":"", "linkTarget":"", "children":[ 204, 205], "overrideUrl":false } { "id":204, "name":"Hiking Boots", "parentId":200, "pageUrl":"products/hiking_boots.html", "hideInNavigation":false, "linkUrl":"", "linkTarger":"", "children":[], "overrideUrl":false }
JavaScript-navigationskode er nødvendig på sitesiderne, så den pågældende struktur også kan læses, og så navigationslinkene til sitet kan udtrækkes. De skabeloner, der følger med Oracle Content Management, omfatter JavaScript-eksempelnavigationsfiler, der illustrerer, hvordan dette virker.
Filen topnav.js
, der bruges i nogle af temaerne i Oracle Content Management, er et eksempel på, hvordan du kan bruge objektet SCS.structureMap
sammen med gengivelses-API-kald, for eksempel SCSRenderAPI.getPageLinkData
, til at gennemgå sitestrukturen og trække den HTML-markup ud, der skal bruges til gengivelse af navigationsmenuerne på siden. Her er kode fra eksempelfilen topnav.js
:
function renderNode(id, navBar) { if (id >= 0) { var navNode = SCS.structureMap[id]; if( navNode && ( ( typeof navNode.hideInNavigation != "boolean" ) || ( navNode.hideInNavigation === false ) ) ) { var navItem = document.createElement("li"); var navLink = document.createElement("a"); var navText = document.createTextNode(navNode.name); var linkData = SCSRenderAPI.getPageLinkData(navNode.id) || {}; if( linkData.href ) { navLink.href = linkData.href; } if( linkData.target ) { navLink.target = linkData.target; } navLink.appendChild(navText); navItem.appendChild(navLink); if (navNode.children.length > 0) { var navSub = document.createElement("ul"); for (var c = 0; c < navNode.children.length; c++) { renderNode(navNode.children[c], navSub); } navItem.appendChild(navSub); } navBar.appendChild(navItem); } } } function renderNav() { var topnav = document.getElementById("topnav"); // expected to be an empty <div> if (topnav) { var navBar = document.createElement("ul"); renderNode(SCS.navigationRoot, navBar); topnav.appendChild(navBar); } } // Must wait for all our script to be ready... if (document.addEventListener) { document.addEventListener('scsrenderstart', renderNav, false); } else if (document.attachEvent) { document.documentElement.scsrenderstart = 0; document.documentElement.attachEvent("onpropertychange", function(event) { if (event && (event.propertyName == "scsrenderstart")) { renderNav(); } } ); }
Du kan bruge gengivelses-API-kald til generering af navigationslinks, der fungerer i redigerings- og eksempeltilstand på sitet og på et publiceret onlinesite. Se Reference til gengivelses-API.
Det er god praksis at placere navigationsoplysninger i én JavaScript-fil, for eksempel topnav.js
. JavaScript-filen gemmes normalt i temaets /assets/js/
-mappe, som du kan se i eksempeltemaerne i Oracle Content Management.