border-top Attribute | borderTop Property
Sets or retrieves the properties of the top border of the object.
Syntax
CSS { border-top : sTop } Scripting [ sTop = ] object.style.borderTop
Possible Values
sTop String that specifies or receives one or more of the following space-delimited values:
- width
- Any of the range of width values available to the borderTopWidth property.
- style
- Any of the range of style values available to the borderTopStyle property.
- color
- Any 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.
DHTML expressions can be used in place of the preceding value(s). As of Internet Explorer 8, expressions are supported in IE7 Standards mode and IE5 (Quirks) mode only. For more information, see About Dynamic Properties and Defining Document Compatibility.
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 Windows Internet Explorer, inline elements must have an
absoluteposition 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>Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/border-top.htm
This example uses inline scripting to change the top border when an onmouseover event occurs.
<TD onmouseover="this.style.borderTop='0.3cm groove yellow'">Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/borderTop.htm
Standards Information
This property is defined in Cascading Style Sheets (CSS), Level 1 (CSS1).
Applies To
A, ABBR, ACRONYM, ARTICLE, ASIDE, B, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, CSSStyleDeclaration, currentStyle, CUSTOM, DD, defaults, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FIGCAPTION, FIGURE, FONT, FOOTER, FORM, FRAME, FRAMESET, HEADER, HGROUP, 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, MARK, MARQUEE, MENU, NAV, NOBR, OBJECT, OL, P, PLAINTEXT, PRE, Q, runtimeStyle, S, SAMP, SECTION, SMALL, SPAN, STRIKE, STRONG, style, SUB, SUP, TABLE, TD, TEXTAREA, TH, TT, U, UL, VAR, XMP, CSSRuleStyleDeclaration Constructor, CSSStyleDeclaration Constructor
See Also
border, CSS Enhancements in Internet Explorer 6
