home / documentation / reference / bordertopwidth

BorderTopWidth

Description:

The width, in pixels, of the menu's top border.

Value:

Integer, or JavaScript expression that returns an integer. Negative values are not allowed.

Applies To:

Menus.

Browser Compatibility:

BorderTopWidth is not supported in Netscape 4.x.

Comments:

You must always specify BorderTopWidth as an integer, or a JavaScript expression that returns an integer. Do not use quoted strings or non-numerical characters when defining BorderTopWidth. BorderTopWidth is always interpreted by HM as pixels.

Setting BorderWidth will automatically set BorderTopWidth, BorderRightWidth, BorderBottomWidth, and BorderLeftWidth in those browsers that support those parameters. Therefore, it is important to supply the BorderWidth parameter before you supply those more specific settings.

The effect of setting the four border widths independently can be visually undesirable in some older browsers (especially IE 4.0/5.0) when one of the border widths is set to 0 and another is set to a valid number. Be sure to test these older browsers when setting your border widths in this fashion.

Do not confuse borders with separators. In HierMenus jargon, borders surround each menu itself, while separators are the bars between individual menu items.

Examples:

// Ok:
BorderTopWidth:5,
BorderTopWidth:0,
BorderTopWidth:(HM_NS4)?3:2, // 3 if NS4, 2 otherwise

// Incorrect:
BorderTopWidth:3.8,
BorderTopWidth:-3,
BorderTopWidth:"2",            // quotes not allowed
BorderTopWidth:"(HM_NS4)?3:2", 
    // no quoted expressions

Default:

2

See Also:

SeparatorSize, BorderWidth, BorderBottomWidth, BorderRightWidth, BorderLeftWidth