border Attribute | border Property
Sets or retrieves the properties to draw around the object.
Syntax
CSS { border : sBorder } Scripting [ sBorder = ] object.style.border
Possible Values
sBorder 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 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. 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 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 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=
thinis identical to border=thinnone; 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 tothin, 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.
If a color is not specified, the text color is used.
For more information about supported colors, see the Color Table.
The border property also applies to input; however, it has no actual function in Windows Internet Explorer, and border has been deprecated in favor of the appropriate CSS markup (see Cascading Style Sheets (CSS)).
As of Microsoft Internet Explorer 5.5, this property applies to inline elements. With earlier versions of 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 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.
<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>Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/border_h.htm
This example uses inline scripting to modify the border property.
<TD onmouseover="this.style.border='0.2cm groove pink'">Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/border_s.htm
Standards Information
This property is defined in Document Object Model (DOM) Level 1 and 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, HEADER, HGROUP, hn, I, IMG, INPUT, 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, HTMLFrameElement Constructor, HTMLIFrameElement Constructor, HTMLImageElement Constructor, HTMLInputElement Constructor, HTMLObjectElement Constructor, HTMLTableElement Constructor
See Also
CSS Enhancements in Internet Explorer 6
