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 expressions

Name 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.