home / documentation / reference / imagevertspace

ImageVertSpace

Description:

The distance, in pixels, between the top edge of the more image and the menu item's padding. You may also specify any one of the keywords top, middle, or bottom.

Value:

Integer, one of top, middle, or bottom, or a JavaScript expression that returns an integer or accepted keyword. Negative integers are not allowed.

Applies To:

Menu Items.

Browser Compatibility:

ImageVertSpace is supported in all browsers.

Comments:

"More" images are the (usually) triangular images that appear within a menu item denoting the existence of a child menu for this menu item.

The above example assumes that ItemPadding has been set to 2, and ImageVertSpace is set to 4.

HierMenus provides several triangular graphics in its distribution file that are suitable for use in menus, however designers are welcome to create their own more images as appropriate. The graphics provided by HierMenus are located in the images sub-directory of the distribution file, and bear names such as HM_More_black_right.gif, HM_More_white_left.gif, etc.

You may use the keywords top, middle, or bottom to let HierMenus automatically set the image to the top, middle (vertically), or bottom of the menu item automatically.

If any value other than top, middle, or bottom is specified, and that value is not numeric, then middle will be assumed.

Note that setting ImageVertSpace to top is the same as setting it to 0 (zero). The top keyword is provided purely for consistency.

When using the keywords, enclose them in quotes. Numbers are always interpreted as pixels.

Examples:

// Ok:
ImageVertSpace:3,
ImageVertSpace:"middle",
ImageVertSpace:(HM_Mac)?"top":"bottom", 
     // top in Mac, bottom all others

// Incorrect:
ImageVertSpace:"7",
ImageVertSpace:10px,
ImageVertSpace:top,     // must quote keywords
ImageVertSpace:'(HM_Mac)?"top":"bottom"', 
     // Do not quote expressions here

Default:

"middle"

See Also:

ImageWidth, ImageHeight, ImageHorizSpace