home / documentation / reference / imagesrcleft

ImageSrcLeft

Description:

The src, i.e., server location, of the default graphic to be used for the more image when RightToLeft menu displays are in effect.

Value:

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

Applies To:

Menu Items.

Browser Compatibility:

ImageSrcLeft 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. ImageSrcLeft is the server location (URL) of the graphic that will be used by default (when the mouse is not over the item) for this more image when RightToLeft menu displays are in effect.

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 ImageSrcLeft. If ImageSrcLeft does not begin with http, then ImageDir is added to the front of ImageSrcLeft to arrive at the actual server location for the image.

If ImageSrcLeft is null and ImageDir is null, no more image is displayed for this item.

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

Examples:

// Ok:
ImageSrcLeft:"HM_More_red_left.gif",
ImageSrcLeft:"http://myserver.com/myHMImages/HM_More_red_left.gif",
ImageSrcLeft:null,
ImageSrcLeft:(window.showMore)?"HM_More_blue_left.gif":null,
    // if the user defined variable "showMore" is true,
    // then use "HM_More_blue_left.gif

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

Default:

"HM_More_black_left.gif"

See Also:

ImageDir, MoreImagesVisible, MoreImageAlt, ImageSrc, ImageSrcOver, ImageSrcLeftOver, ImageWidth, ImageHeight, ImageHorizSpace, ImagevertSpace