メニュー

メニューコントロールはアプリケーションのメニューを表示します。ナビゲーションパネルを含むページ構造、例えばApplicationContentNMやApplicationContentNMIで使用します。これらのページ構造にはナビゲーションというプレースホルダーがあり、ここにメニューコントロールを配置する必要があります。

メニューにアイテムへのリンクを埋めるには、メニューに含みたいアイテムのルート項目のSitecore IDを指定します。 メニュー コントロールは2つの方法でメニューを埋めることができます:

• メニューのルートとしてSPEAKページを指し示します。

  メニューコントロールは、コンテンツツリー内のこのルートアイテムの下にあるアイテムの構造に対応するメニューを作成します。ルートアイテムの直接的な子項目は、メニュー内のトップレベルの折りたたみセクションとして表示されます。ルート項目自体と直接の子項目については、アイコンがある場合、メニューコントロールでアイテムのアイコンが表示されます。メニューコントロールでルートアイテムを表示しないことも指定できます。コントロールは、PageSettings項目およびそれらの項目の下にある項目を除く、すべての後続子項目へのリンクを作成します。

• HyperlinkButtonパラメータアイテムのツリーを作成し、そのツリーのルートを指し示します。

  各HyperlinkButtonパラメータ 項目のNavigationUrlフィールドでリンクの宛先を指定します。 HyperlinkButtonパラメータ項目 のクリックフィールドを使ってJavaScriptに応答するリンクを作成し、Targetフィールドでリンクを新しいウィンドウで開くように指定できます。最後に、HyperlinkButtonパラメータ 項目を使うことでURLにクエリを追加できます。

!注クエリでURLを入力すると、メニューコントロールがリンクを解析できず、メニュー内でリンクをハイライトできない場合があります。URLにアイテムのIDを追加することで、正しいリンクを見つけるのをコントロールで助けることができます。例えば: somewhere.com/my_page?value=5&menuItemId={123-346-47554763346}

メニューコントロールには、メニューの初期状態を指定するために使う2つのプロパティがあります:

• DefaultSelectedItemId: メニュー コントロールが選択するリンクを指定し、ユーザーがメニューでページを初めて開いたときにハイライトします。
• ExpandedItemIds
  メニューコントロールで 展開するトップレベルの折りたたみセクションを指定します。複数のセクションをカンマ区切られたリストとして入力できます。

ユーザーがページを訪れると、メニュー コントロールは折りたたみ可能なセクションの状態と選択を記憶します。