border Attribute | border Property

Sets or retrieves the properties to be drawn around the object.

Syntax

HTML { border: sBorder }

Scripting object.style.border [ = sBorder] ]

HTML	{ border: sBorder }
Scripting	object.style.border [ = sBorder] ]

Possible Values

sBorder String that specifies one or more of the following space-delimited values:

width Any of the range of width values available to the borderWidth property.

style Any of the range of style values available to the borderStyle property.

color Any of the range of color values available to the borderColor property.

The property is read/write with a default value of medium none; the cascading style sheets (CSS) attribute is not inherited.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see Dynamic Properties.

Remarks

The border property is a composite property that sets the width, style, and color values for all four sides of an object.

You must specify a style when specifying a width and/or color; otherwise, the border does not render.

All individual border properties not set by the composite border property are set to their default values. For example, the default value for width is medium.

The setting border=thin is identical to border=thin none; the default value for the border color is the same as the text color if one is not initially set. So, not only does the property set width to thin, it also clears any style or color values previously set.

Setting a border to zero or omitting the attribute causes no border to be displayed. Supplying the border attribute without a value defaults to a single border.

To use this property, inline elements must have an absolute position or layout. Element layout is set by providing a value for the height property or the width property.

If a color is not specified, the text color is used.

For more information about supported colors, see the Color Table.

Example

The following examples use the border attribute and the border property to specify the composite border properties.

This example uses a call to an embedded (global) style sheet to modify the border attribute.

Sample Code
<HEAD>
<STYLE>
    .applyBorder { border:0.2cm groove orange }
    .removeBorder { border:none }
</STYLE>
</HEAD>
<BODY>
<TABLE BORDER>
<TR> 
    <TD onmouseover="this.className='applyBorder'"
        onmouseout="this.className='removeBorder'">
    <IMG src="sphere.jpg"></TD>
</TR>
</TABLE>
This feature requires Internet Explorer 4.0 or later. Click the icon below to install the latest version. Then reload this page to view the sample.

This example uses inline scripting to modify the border property.
<TD onmouseover="this.style.border='0.2cm groove pink'">
This feature requires Internet Explorer 4.0 or later. Click the icon below to install the latest version. Then reload this page to view the sample.

Applies To

[ Object Name ]

Platform Version

Win16:

Win32:

Mac:

Unix:

WinCE:

Version data is listed when the mouse hovers over a link, or the link has focus.

BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, custom, DD, DIR, DIV, DL, DT, EMBED, FIELDSET, FORM, Hn, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, ISINDEX, LI, LISTING, MARQUEE, MENU, OBJECT, OL, P, PLAINTEXT, PRE, runtimeStyle, SPAN, style, TABLE, TD, TEXTAREA, TH, UL, XMP