border-style Attribute | borderStyle Property

Internet Development Index

Sets or retrieves the style of the left, right, top, and bottom borders of the object.

Syntax

HTML { border-style : sStyle }
Scriptingobject.style.borderStyle [ = sStyle ]

Possible Values

sStyleString that specifies or receives one of the following values.
noneDefault. No border is drawn, regardless of any specified borderWidth.
dottedBorder is a dotted line. This value is supported on the Macintosh platform, as of Microsoft® Internet Explorer 4.01, and on the Microsoft Windows® platform, as of Internet Explorer 5.5. It renders as a solid line on Unix platforms, and on Windows systems running earlier versions of Internet Explorer.
dashedBorder is a dashed line. This value is supported on the Macintosh platform as of Internet Explorer 4.01 and on the Windows platform, as of Internet Explorer 5.5. It renders as a solid line on Unix platforms, and on Windows systems running earlier versions of Internet Explorer.
solidBorder is a solid line.
doubleBorder is a double line drawn on top of the background of the object. The sum of the two single lines and the space between equals the borderWidth value. The border width must be at least 3 pixels wide to draw a double border.
groove3-D groove is drawn in colors based on the value. The borderWidth property of the object must be specified for the style to render correctly.
ridge3-D ridge is drawn in colors based on the value.
inset3-D inset is drawn in colors based on the value.
window-insetBorder is the same as inset, but is surrounded by an additional single line, drawn in colors based on the value.
outset3-D outset is drawn in colors based on the value.

The property is read/write for all objects except the following, for which it is read-only: currentStyle. The property has a default value of 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 About Dynamic Properties.

Remarks

As of Internet Explorer 5.5, this property applies to inline elements. With earlier versions of Internet Explorer, inline elements must have an absolute?A HREF="../properties/position.html">position or layout to use this property. Element layout is set by providing a value for the height property or the width property.

Examples

The following examples use the border-style attribute and the borderStyle property to specify the border style.

This example uses a call to an embedded (global) style sheet to change the style of the border to groove when an onmouseover event occurs.

<HEAD>
<STYLE>
TD	{ border-style:solid; border-width:0.5cm }
.change { border-style:groove }
</STYLE>
</HEAD>
<BODY>
<TABLE BORDER>
<TR>
<TD onmouseover="this.className='change'"
onmouseout="this.className=''">
<IMG src="sphere.jpg">
</TD>
</TR>
</TABLE>
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

This example uses inline scripting to change the style of the border to groove when an onmouseover event occurs.

<TD onmouseover="this.style.borderWidth='0.5cm';
this.style.borderStyle='groove'">
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

This property is defined in Cascading Style Sheets (CSS), Level 1 (CSS1) Non-Microsoft link.

Applies To

A, ACRONYM, B, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, currentStyle, CUSTOM, DD, defaults, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, hn, HR, I, 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, INS, ISINDEX, KBD, LABEL, LI, LISTING, MARQUEE, MENU, NOBR, OBJECT, OL, P, PLAINTEXT, PRE, Q, runtimeStyle, S, SAMP, SMALL, SPAN, STRIKE, STRONG, style, SUB, SUP, TABLE, TD, TEXTAREA, TH, TT, U, UL, VAR, XMP

See Also

border