width property

Sets or retrieves the width of the object.

Syntax

width: auto | width | percentage

Property values

auto

Default. Default width of the object.

width

Floating-point number, followed by an absolute units designator (cm, mm, in, pt, or pc) or a relative units designator (em, ex, or px). For more information about the supported length units, see CSS Values and Units Reference.

percentage

Integer, followed by a %. The value is a percentage of the width of the parent object, whether or not it is specified explicitly. Negative values are not allowed.

CSS information

Remarks

As of Microsoft Internet Explorer 6, when you use the !DOCTYPE declaration to specify standards-compliant mode, this property specifies the distance between the left and right edges of the content box—that is, within the padding.

When the !DOCTYPE declaration does not specify standards-compliant mode, and with earlier versions of Windows Internet Explorer, this property includes the object's content box, plus the values of the following properties: border-left, border-right, padding-left, and padding-right. Subtracting the sum of the values of these properties from the value of the width property equals the width of the parent object's content box.

To perform operations on the numeric value of this property, use pixelWidth or posWidth.

For more information about how to access the dimension and location of elements on the page through the Dynamic HTML (DHTML) Document Object Model (DOM), see Measuring Element Dimension and Location with CSSOM in Internet Explorer 9.

Examples

This example uses an inline style sheet to set the width of an image.The following examples use the width attribute and the width property to change the width of the object.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/width_h.htm

<DIV STYLE="position:absolute;top:10px;left:10px;width:1in">
. . . </DIV>

This example uses inline scripting to set the width of an image when an onclick event occurs.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/width_s.htm

<IMG SRC="sphere.jpg" onclick="this.style.width='1cm'"
    ondblclick="this.style.width=''">

See also

CSSStyleDeclaration

currentStyle

runtimeStyle

style

Conceptual

Measuring Element Dimension and Location with CSSOM in Internet Explorer 9

Other Resources

CSS Enhancements in Internet Explorer 6

Send comments about this topic to Microsoft

Build date: 11/29/2012