サイト・ナビゲーション

サイトの階層は、サイトに関連付けられたstructure.jsonファイルに格納されます。階層は、メモリーにロードされ、SCS.structureMapオブジェクトとしてページ・コンテキストで使用可能になります。

サイト・ビルダーは、サイト・ビルダーでサイト・ツリーを描画するためにstructure.jsonファイルを読み取ります。structure.jsonファイルには、サイト・ページのコードが含まれます。例:

"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コードも必要です。Oracle Content Managementに用意されているテンプレートには、この仕組みを説明するサンプルのナビゲーションJavaScriptファイルが含まれます。

Oracle Content Managementに用意されているいくつかのテーマで使用されるtopnav.jsファイルは、SCS.structureMapオブジェクトをレンダリングAPIコール(SCSRenderAPI.getPageLinkDataなど)とともに使用して、サイト構造を横断する方法や、ページ内のナビゲーション・リンクをレンダリングするために必要なHTMLマークアップを描画する方法の例です。サンプルの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();
                        }
                }
        );
}

レンダリングAPIコールを使用して、編集およびプレビューモードのサイト内および公開済オンライン・サイトで機能するナビゲーション・リンクを生成できます。レンダリングAPIリファレンスを参照してください。

ナビゲーション情報は1つのJavaScriptファイル(topnav.jsなど)に格納することをお薦めします。JavaScriptファイルは通常、Oracle Content Managementに用意されているサンプル・テーマの場合と同じように、テーマの/assets/js/フォルダに格納されます。