home / documentation / reference / imagedir

ImageDir

Description:

The server directory (folder) where the HierMenus "more" image graphics are stored.

Value:

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

Applies To:

Menus and Menu Items.

Browser Compatibility:

ImageDir is supported in all browsers.

Comments:

ImageDir is the server directory, specified as a valid URL, of the location on your Web server of HierMenus' image graphics. HierMenus uses these image graphics as the default graphics for the triangular images that appear in a menu item when that menu item has a child menu, and the graphical images that appear in the top and bottom scroll bars of scrollable menus.

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.

When set to something other than null, ImageDir must always end with a trailing slash (/).

Note how the configuration parameter setting ImageDir interacts with the individual graphical parameters ImageSrc, ImageSrcOver, ImageSrcLeft, ImageSrcLeftOver, ScollImageSrcTop, and ScrollImageSrcBot. In each case, if the specific parameter does not begin with http, then ImageDir is added to the front of the specific parameter setting to arrive at the actual server location for the image. For example, given these two settings:

ImageDir:"http://mydomain.com/myImages/",
ImageSrc:"HM_More_black_right.gif"

HierMenus would attempt to retrieve this file from the server http://mydomain.com/myImages/HM_More_black_right.gif

If ImageDir is set to null, then each of the above mentioned images will be assumed to be within the same directory as the HTML page that is displaying menus (optionally, you may also provide full URL path names in the individual parameter names if you prefer).

ImageDir has no effect on your own embedded images, i.e., images that you've embedded within your menu items via the HTML <img> tag.

Examples:

// Ok:
ImageDir:"http://mydomain.com/myimages/",
ImageDir:"/myimages/",  // Web server root relative address
ImageDir:"myimages/",   // relative to directory of HTML page 
ImageDir:null,
ImageDir:(window.img1)?"/image1dir/":"/image2dir/",
    // if the user defined variable "img1" is true,
    // then use "/image1dir/"; otherwise "/image2dir/"

// Incorrect:
ImageDir:http://mydomain.com/img/,  // Strings must be quoted
ImageDir:"null",                    // null must NOT be quoted
ImageDir:'(window.img1)?"/image1dir/":"/image2dir/"',
    // no quoted expressions

Default:

HM_ImageDir. That is, by default HierMenus copies the value specified for HM_ImageDir (in the HM_Loader.js file) into ImageDir.

See Also:

ImageSrc, ImageSrcLeft, ImageSrcOver, ImageSrcOver, ScrollImageSrcTop, ScrollImageSrcBot