menu:item
Look in the menu for a specific menu item within the context
of a use
tag, and make this item available as
a scripting variable. The normal use of this tag is to search the menu
for the menu item to highlight:
<menu:item id="currentitem"/>
This will take the current request (request for an article or
section, and look for it in the enclosing
<menu:use>
menu. If the menu item is
found, the item will be made available as a scripting
variable.
Another common usage scenario is to find the menu item for the root section. This is often done to highlight the front page in some special way:
<menu:item id="rootitem" sectionUniqueName="ece_frontpage"/>
When iterating over the menu, it is normal to highlight
certain menu items in different ways. By using
<view:relationships>
it is possible to
do simple calculations to highlight the current item, its siblings, its
ancestors, children, and so on.
Syntax
<menu:item article="..."? id="..." link="..."? section="..."? sectionId="..."? sectionUniqueName="..."?/>
Attributes
id
, mandatory, no runtime expressionsName of the scripting variable to export. The scripting variable will be one of the menu items in the enclosing
<menu:use>
tag.section
The section object to look for in the menu. If not specified, the current section will be used.
sectionUniqueName
The unique-name of the section to look for in the menu.. If not specified, the current section will be used.
sectionId
The ID of the section to look for in the menu. If not specified, the current section will be used.
article
The ID of the article to look for in the menu. If not specified, the current article will be used, if there is a current article. If not, articles will be ignored..
link
The URL of the link to look for in the menu. If not specified, links will be ignored.