• This web contains the official documentation of the
TWiki Release 4.2, code named
FreetownRelease. It is a read-only web for reference.
• This is an older release, see
TWiki-6.1 for the latest release documentation.
Hierarchical Navigation
Navigation block that displays the current topic, its parent and children (if any).
This is intended to be included in other topics, for example in a side navigation bar (
WebLeftBar).
NOTE: The lookup for parent and children will increase the loading time of your pages.
Usage
Two sections are defined:
Displaying the Parent - Current - Children block
%INCLUDE{"%SYSTEMWEB%.HierarchicalNavigation" section="all"}%
generates:
When included in
WebLeftBar (using default Pattern skin) this is styled to:
Displaying child topics
*Child topics:*
%INCLUDE{"%SYSTEMWEB%.HierarchicalNavigation" section="children"}%
generates:
Child topics:
When included in
WebLeftBar (using default Pattern skin) this is styled to:
%STARTSECTION{name="all"}%<div class="twikiHierarchicalNavigation">
<ul>
%SEARCH{
"parent"
type="query"
topic="%BASETOPIC%"
web="%BASEWEB%"
nonoise="on"
format="<li class='twikiParentTopic'><img src='%ICONURL{parent_gray}%' width='16' height='16' alt='' border='0' /> [[$web.$parent][$parent]]</li>"
}%
<li class='twikiCurrentTopic' style='font-weight:bold;'><nop>%BASETOPIC%</li>%INCLUDE{"%TOPIC%" section="childlist"}%
</ul>
</div><!--/twikiHierarchicalNavigation-->%ENDSECTION{name="all"}%
%STARTSECTION{name="children"}%<div class="twikiHierarchicalNavigation">
<ul>%INCLUDE{"%TOPIC%" section="childlist"}%</ul>
</div><!--/twikiHierarchicalNavigation-->%ENDSECTION{name="children"}%</div>%ENDSECTION{name="children"}%
%STARTSECTION{name="childlist"}%%SEARCH{
"parent.name='%BASETOPIC%'"
web="%BASEWEB%"
type="query"
nonoise="on"
format="<li class='childTopic'><img src='%ICONURL{line_ur_gray}%' width='16' height='16' alt='' border='0' /> [[$web.$topic][$topic]]</li>"
}%%ENDSECTION{name="childlist"}%