border-top Attribute | borderTop

HTML (DHTML)

border-top Attribute | borderTop Property

Internet Development Index

Sets or retrieves the properties of the top border of the object.

Syntax

HTML { border-top : sTop }
Scriptingobject.style.borderTop [ = sTop ]

Possible Values

sTopString that specifies or receives one or more of the following space-delimited values:
widthAny of the range of width values available to the borderTopWidth property.
styleAny of the range of style values available to the borderTopStyle property.
colorAny of the range of color values available to the borderTopColor property.

The property is read/write. The property has 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 About Dynamic Properties.

Remarks

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

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

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

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

As of Microsoft® 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-top attribute and the borderTop property to specify the composite properties.

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

<HEAD>
<STYLE>
TD 	{ border-top:0.5cm solid yellow }
.change { border-top:0.5cm groove pink }
</STYLE>
</HEAD>
<BODY>
<TABLE>
<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 top border when an onmouseover event occurs.

<TD onmouseover="this.style.borderTop='0.3cm groove yellow'">
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, CUSTOM, DD, defaults, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAMESET, FRAME, hn, 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, CSS Enhancements in Internet Explorer 6