Menu Item Details

Open All  Close All  Locate  Move Previous  Move Next 


iNavigate Menu Item Details: controls the settings for each individual menu item.



Page Type

Regular Page
Most of your menu items will be regular pages.

Home Page
iNavigate needs to know which is the home page, so it can recognize it when the url is just the domain name. You can only have one page selected as your home page, if you select another then the previous selection will be changed to a regular page. If a home page is not already specified and you add index.htm(l) or home.htm(l) then that will automatically be marked as the home page. Selecting this option causes the generation of the iNavigate.HomePage property:

iNavigate.HomePage = 'Welcome.html';

Sub Page
A sub page is a child page which does not appear in the HTML menu structure. It is shown on the generator's menu tree but not in the actual menus. The sub page will contain the menu structure with the pointer set on its parent.

Foreign Page
A foreign page is one which is not in the current menu group. A typical use of this is to construct layered menu groups, where the top layer is a high level menu (say a list of products) and some items drop you into the next layer (the full menu structure for that product). The foreign page is included in the generated menus, but does not itself get processed during generation.

Site Map Page
A Site Map page is one which contains your site map.

Exclude from Menu
Excludes a Page from the menu. For example, you can choose to exclude your site map page and have it global to your site as part of the footer.

Convert Parent Link of Sub Page
By default iNavigate does not convert parent page links to text on sub pages, so that the user can use the link to navigate back to the parent page. Selecting this option causes the parent link to be converted. You might want to do this if you sub page has it's own navigation links. Selecting this option causes the generation of the iNavigate.ConvertParent property:

iNavigate.ConvertParent = true;

File Name
Sets the file name for an individual menu item.

Caption
Sets the link caption for an individual menu item.

Allow Link Caption to Wrap
Allows the link caption for an individual menu item to wrap. The iNavigate default behavior is 'nowrap'.

Tooltip
Sets the tooltip text for an individual menu item. This causes the generation of the 'title' html attribute on the menu item, for example

<a id="iNavigateItem" href="Index.htm" title="Overview" onMouseOver="window.status='Overview';return true" onMouseOut="window.status='';return true">Overview</a>

It is also possible to integrate custom or 3rd party tooltip components with iNavigate menu items. For details on how to do this please refer to the HOW TO item in the ReadMe.txt file.

URL
Sets the URL for an individual menu item. The URL should consist of only the file name part, the appropriate relative path will be inserted during generation.

The URL may also be a JavaScript URL, in which case the iNavigate.PageSeach.page property is generated by default to match:

iNavigate.PageSeach.page = 'javascript(page7, true, 78)';

Match URL Query String
iNavigate points to and highlights the correct menu in the menu structures by searching for the current page in those structures. Normally this search is based on the page url, however in these more advanced scenarios, additional information may be required.

By default iNavigate ignores the Query String portion of the url when searching for a matching link in the menu structure. Selecting this option causes the search to match on the Query String portion in addition to the filename portion. For even more fine control over link identification, you can use the PageSeach properties. Selecting this option causes the iNavigate.MatchQueryString property to be generated:

iNavigate.MatchQueryString = true;

PageSeach Page
Specifying a value (which may be text or a regular expression) for this option tells iNavigate to look for that value in the menu structures, rather than the page url.

Typically this needs to be set for sub pages, with the url of the corresponding parent page. In fact for sub pages, the generator automatically sets this value for you (if the url of the parent page is available).

Selecting this option causes the iNavigate.PageSeach.page property to be generated:

iNavigate.PageSeach.page = 'TonsOfStuff.htm';

PageSeach Querystring
Specifying a value (which may be text or a regular expression) for this option tells iNavigate to look for that query string value in the menu structures, rather than the page url query string.

This is most commonly used for server application pages. How exactly you identify application pages will depend on how your application uses url filenames and query strings.

If you have a distinct filename for each page (eg login.asp, new.asp, delete.asp, etc) then you can simply set these file names in the menu structure in the normal way. (The query string part of the url is ignored by default).

However if you use the query string to identify pages for application routing, you will need to specify a value here to let iNavigate recognize the corresponding menu item. The most effective way to do this is with a simple regular expression in the querystring property. Using a regular expression means that any extra information in the query string will not prevent a match being identified, for example:

iNavigate.PageSeach.page = 'myapp.asp';
iNavigate.PageSeach.querystring = /page=Report/i;

This will match all of the following urls:
  • myapp.asp?page=Report
  • myapp.asp?page=ReportSummary
  • myapp.asp?page=Report&Item=911&Level=3
Target
Sets the Target frame or window in which an individual menu item will be displayed, for example _blank creates a new window for the menu item.

From the iNavigate Advanced Link Identification Panel you can configure iNavigate to recognize your pages in more advanced scenarios, such as the use of url Query Strings (the portion or a url after the ?) and server application pages.