borderWidth Property (A, ABBR, ACRONYM, ...)

Switch View :
Classic
Lightweight
ScriptFree
border-width Attribute | borderWidth Property

Gets or sets the width of the left, right, top, and bottom borders of the object.

Syntax

CSS { border-width : sWidth }
Scripting [ sWidth = ] object.style.borderWidth

Possible Values

sWidth String that specifies or receives up to four of the following values:
medium
Default.  
thin
Width less than the default.
thick
Width greater than the default.
width
Width consisting of a floating-point number, followed by an absolute units designator (cm, mm, in, pt, or pc) or a relative units designator (em, ex, or px)

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 medium. 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

Up to four different widths can be specified, in the following order: top, right, bottom, left. If one width is specified, it is used for all four sides. If two widths are specified, the first is used for the top and bottom borders, and the second is used for left and right borders. If three widths are specified, they are used for top, right/left, and bottom borders, respectively.

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 absolute  position or layout to use this property. Element layout is set by providing a value for the height property or the width property.

The borderWidth property does not render if the borderStyle property is set to none.

Examples

The following examples use the border-width attribute and the borderWidth property to specify the width of the border.

This example uses a call to an embedded (global) style sheet to change the width of the border to 1 centimeter when a mouse click occurs.


<HEAD>
<STYLE>
    TD { border-width:3mm }
    .changeborder1 { border-width:1cm }
</STYLE>
</HEAD>
<BODY> 
<TABLE BORDER>
<TR>
    <TD onclick="this.className='changeborder1'"
        ondblclick="this.className=''">
        <IMG src="sphere.jpg"></TD>
</TR>
</TABLE>

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/border-width.htm

This example uses inline script to change the width of the border to 1 centimeter when a mouse click occurs.


<TD onclick="this.style.borderWidth='1cm'">

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/borderWidth.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, HEADER, HGROUP, 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, 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, CSSCurrentStyleDeclaration Constructor, CSSRuleStyleDeclaration Constructor, CSSStyleDeclaration Constructor

See Also

border, CSS Enhancements in Internet Explorer 6