1 # <a name="Hierarchical Navigation"></a><a name=" Hierarchical Navigation"></a> Hierarchical Navigation
3 **Navigation block that displays the current topic, its parent and children (if any).** %BR% This is intended to be included in other topics, for example in a side navigation bar ([[WebLeftBar]]).
5 _NOTE: The lookup for parent and children will increase the loading time of your pages._
9 <li><a href="#Usage"> Usage</a><ul>
10 <li><a href="#Displaying the Parent - Current"> Displaying the Parent - Current - Children block</a></li>
11 <li><a href="#Displaying child topics"> Displaying child topics</a></li>
17 ## <a name="Usage"></a> Usage
19 Two sections are defined:
24 ### <a name="Displaying the Parent - Current"></a><a name="Displaying the Parent - Current "></a> Displaying the Parent - Current - Children block
26 > %INCLUDE{"%SYSTEMWEB%.HierarchicalNavigation" section="all"}%
30 When included in [[WebLeftBar]] (using default Pattern skin) this is styled to:
32 <div id="patternLeftBarContents">
37 ### <a name="Displaying child topics"></a> Displaying child topics
40 > %INCLUDE{"%SYSTEMWEB%.HierarchicalNavigation" section="children"}%
46 When included in [[WebLeftBar]] (using default Pattern skin) this is styled to:
48 <div id="patternLeftBarContents">
53 %STARTSECTION{name="all"}%<div class="twikiHierarchicalNavigation">
61 format="<li class='twikiParentTopic'><img src='%ICONURL{parent_gray}%' width='16' height='16' alt='' border='0' /> [[$web.$parent][$parent]]</li>"
63 <li class='twikiCurrentTopic' style='font-weight:bold;'><nop>%BASETOPIC%</li>%INCLUDE{"%TOPIC%" section="childlist"}%
65 </div><!--/twikiHierarchicalNavigation-->%ENDSECTION{name="all"}%
67 %STARTSECTION{name="children"}%<div class="twikiHierarchicalNavigation">
68 <ul>%INCLUDE{"%TOPIC%" section="childlist"}%</ul>
69 </div><!--/twikiHierarchicalNavigation-->%ENDSECTION{name="children"}%</div>%ENDSECTION{name="children"}%
71 %STARTSECTION{name="childlist"}%%SEARCH{
72 "parent.name='%BASETOPIC%'"
76 format="<li class='childTopic'><img src='%ICONURL{line_ur_gray}%' width='16' height='16' alt='' border='0' /> [[$web.$topic][$topic]]</li>"
77 }%%ENDSECTION{name="childlist"}%