Widget Tag
++VSUBNAV++
What It Does
The ++VSUBNAV++ widget creates a vertical text navigation bar for the subsections of your site. This widget is sensitive to the location of the page, so only the subsections of the current section are shown in the++VSUBNAV++ widget.
The ++VSUBNAV++ widget also highlights the subsection in which the user is currently located, and highlights the other subsection links when the cursor passes over them.
The Markup Results
The ++VSUBNAV++ widget may be generated in one of two forms depending on your "Site Navigation" widget settings (see below).
- No table. The widget is a set of block elements: Each subsection link is enclosed in its own
<div>tag. - Table. The widget is a block element contained in a
<table>tag. The width and cell padding of the table is controlled by the widget settings.
Templates Using This Widget
This widget may be used in all page templates except the homepage:
- Main section page
- Subsection index page
- Article page
Customizing This Widget
Users with webmaster or administrator accounts can customize this widget in the "Site Navigation" section of the widget editor. To get there, click the "Widget Settings" link in the left-column menu of the Big Medium control panel. The following settings affect the ++VSUBNAV++ widget:
- Highlight color for active section. This determines the color used to highlight the subsection in which the user is currently located as well as the rollover highlight when the cursor passes over subsection links. This color must be in hexadecimal format (click here for a list of hexadecimal codes for web-safe colors).
- "Button" padding. This determines the cell padding (the amount of space around the text links) for the text navigation bar.
- Use tables for vertical text-based subnavigation. Checking this option makes Big Medium use the table format for the
++VSUBNAV++widget (see "The Markup Results" above). - Table width for vertical text-based subnavigation. If you choose to use the table format for the
++VSUBNAV++widget, this setting determines the width of the table. This may be a percentage or a straight number.
In addition, section editor settings determine whether individual subsections are included in the ++VSUBNAV++ widget. For more information, check the section status help file.
Styles
The section links in the ++VSUBNAV++ widget are displayed in the "Navigation Menu Links" style, which may be edited by webmasters or administrators in the site's styles editor.
Need more help?
For further assistance and documentation, visit the website of Global Moxie, the developer behind Big Medium.