home / documentation / reference / imagesrcleftover

ImageSrcLeftOver

Description:

The src, i.e., server location, of the graphic to be used for the more image when the mouse is hovering over the menu item and RightToLeft menu displays are in effect. Also assigned to the more image of parent items if their child menus are visible and the item's KeepHilite parameter is set to true.

Value:

String, null, or JavaScript expression that returns a String/null.

Applies To:

Menu Items.

Browser Compatibility:

ImageSrcLeftOver 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. ImageSrcLeftOver is the server location (URL) of the graphic that will be used for this more image when the mouse hovers over the item, or in parent items when their child menus are visible and their KeepHilite parameters are set to true. ImageSrcLeftOver is only used when RightToLeft menu displays are in effect. By setting ImageSrcLeftOver to a different graphic than ImageSrcLeft, a rollover effect is created with the more image.

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.

Note how the configuration parameter setting ImageDir interacts with ImageSrcLeftOver. If ImageSrcLeftOver does not begin with http, then ImageDir is added to the front of ImageSrcLeftOver to arrive at the actual server location for the image.

If ImageSrcLeftOver is null and ImageDir is null, or if ImageSrcLeftOver is the same as ImageSrcLeft, no rollover effect is provided for the more image.

ImageSrcLeftOver is used as the more rollover graphic for right-to-left menus. When right-to-left menu displays are not in effect (when RightToLeft is false), HierMenus uses ImageSrcOver as the rollover image graphic.

Examples:

// Ok:
ImageSrcLeftOver:"HM_More_black_left.gif",
ImageSrcLeftOver:"http://myserver.com/img/HM_More_black_left.gif",
ImageSrcLeftOver:null,
ImageSrcLeftOver:(window.showMore)?"HM_More_green_left.gif":null,
    // if the user defined variable "showMore" is true,
    // then use "HM_More_green_left.gif

// Incorrect:
ImageSrcLeftOver:HM_More_blue_left.gif,  // Strings must be quoted
ImageSrcLeftOver:"null",                   // null must NOT be quoted
ImageSrcLeftOver:'(window.showMore)?"HM_More_green_left.gif":null', 
    // no quoted expressions

Default:

"HM_More_white_left.gif"

See Also:

ImageDir, PreloadImages, IsPermHilite, IsSelected, IsRollover, KeepHilite, MoreImagesVisible, MoreImageAlt, ImageSrc, ImageSrcLeft, ImageSrcOver, ImageWidth, ImageHeight, ImageHorizSpace, ImagevertSpace