home / documentation / reference / imagesrc

ImageSrc

Description:

The src, i.e., server location, of the default graphic to be used for the more image.

Value:

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

Applies To:

Menu Items.

Browser Compatibility:

ImageSrc 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. ImageSrc 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.

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

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

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

Examples:

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

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

Default:

"HM_More_black_right.gif"

See Also:

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