Element.clientWidth

  • Revision slug: DOM/element.clientWidth
  • Revision title: element.clientWidth
  • Revision id: 164694
  • Created:
  • Creator: GT
  • Is current revision? No
  • Comment

Revision Content

{{template.DomRef()}}

clientWidth

{{template.Abbr("DHTML", "Dynamic HyperText Markup Language")}} property that represents the inner width of an element. This includes possible padding but not vertical scrollbar (if present, if rendered), not border nor margin. If the element has a vertical scrollbar, then its width value is substracted from the css width property value and from the horizontal css padding value of the element in the computation of the clientWidth value.

Syntax and values

var intElemClientWidth = document.getElementById(id_attribute_value).clientWidth;

intElemClientWidth is a variable storing an integer corresponding to the clientWidth pixel value of the element. clientWidth is a read-only property.

Description

An element's clientWidth is a measurement which includes the element CSS width and the element horizontal padding and, if rendered, substracting the width of the vertical scrollbar.

Example

padding-top

Gentle, individualistic and very loyal, Birman cats fall between Siamese and Persian in character. If you admire cats that are non aggressive, that enjoy being with humans and tend to be on the quiet side, you may well find that Birman cats are just the felines for you.

Image:BirmanCat.jpgAll Birmans have colorpointed features, dark coloration of the face, ears, legs and tail.

Cat image and text coming from www.best-cat-art.com

padding-bottom

LeftTopRightBottommargin-topmargin-bottomborder-topborder-bottom{{mediawiki.external('if IE')}}><span id="MrgLeft" style="position: absolute; left: 8px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">margin-left</span><span id="BrdLeft" style="position: absolute; left: 33px; top: 65px; color: white; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">border-left</span><span id="PdgLeft" style="position: absolute; left: 55px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">padding-left</span><span id="PdgRight" style="position: absolute; left: 275px; top: 60px; color: black; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl; white-space: nowrap;">padding-right</span><span id="BrdRight" style="position: absolute; left: 310px; top: 65px; color: white; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">border-right</span><span id="MrgRight" style="position: absolute; left: 340px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">margin-right</span><!{{mediawiki.external('endif')}}

Image:clientWidth.png

Specification

clientWidth is part of the MSIE's {{template.Abbr("DHTML", "Dynamic HyperText Markup Language")}} object model. clientWidth is not part of any W3C specification or technical recommendation.

Notes

clientWidth is a property of the {{template.Abbr("DHTML", "Dynamic HyperText Markup Language")}} object model which was first introduced by MSIE. It represents the inner width of an element.

References

Revision Source

<p>
{{template.DomRef()}}
</p>
<h3 name="clientWidth">clientWidth</h3>
<p>{{template.Abbr("DHTML", "Dynamic HyperText Markup Language")}} property that represents the inner width of an element. This includes possible padding but not vertical scrollbar (if present, if rendered), not border nor margin. If the element has a vertical scrollbar, then its width value is substracted from the css width property value and from the horizontal css padding value of the element in the computation of the clientWidth value.
</p>
<h3 name="Syntax_and_values">Syntax and values</h3>
<pre class="eval">var <i>intElemClientWidth</i> = document.getElementById(<i>id_attribute_value</i>).clientWidth;
</pre>
<p><i>intElemClientWidth</i> is a variable storing an integer corresponding to the clientWidth pixel value of the element.
clientWidth is a read-only property.
</p>
<h3 name="Description">Description</h3>
<p>An element's <b>clientWidth</b> is a measurement which includes the element CSS width and the element horizontal padding and, if rendered, substracting the width of the vertical scrollbar.
</p>
<h3 name="Example">Example</h3>
<div id="offsetContainer" style="margin: 26px 0px; background-color: rgb(255, 255, 204); border: 4px dashed black; color: black; position: absolute; left: 260px;"><div id="idDiv" style="margin: 24px 29px; border: 24px black solid; padding: 0px 28px; width: 199px; height: 102px; overflow: auto; background-color: white; font-size: 13px!important; font-family: Arial, sans-serif;"><p id="PaddingTopLabel" style="text-align: center; font-style: italic; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif; margin: 0px;">padding-top</p>
<p>Gentle, individualistic and very loyal, Birman cats fall between Siamese and Persian in character. If you admire cats that are non aggressive, that enjoy being with humans and tend to be on the quiet side, you may well find that Birman cats are just the felines for you.</p>
<p><span style="float: right;"><img alt="Image:BirmanCat.jpg" src="File:en/Media_Gallery/BirmanCat.jpg"></span>All Birmans have colorpointed features, dark coloration of the face, ears, legs and tail.</p>
<p>Cat image and text coming from <a class="external" href="http://www.best-cat-art.com/">www.best-cat-art.com</a></p>
<p id="PaddingBottomLabel" style="text-align: center; font-style: italic; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif; margin: 0px;">padding-bottom</p></div><span style="position: absolute; left: -32px; top: 85px; color: blue; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">Left</span><span style="position: absolute; left: 170px; top: -20px; color: blue; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">Top</span><span style="position: absolute; left: 370px; top: 85px; color: blue; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">Right</span><span style="position: absolute; left: 164px; top: 203px; color: blue; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">Bottom</span><span style="position: absolute; left: 143px; top: 5px; font-style: italic; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">margin-top</span><span style="position: absolute; left: 138px; top: 175px; font-style: italic; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">margin-bottom</span><span style="position: absolute; left: 143px; top: 27px; color: white; font-style: italic; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">border-top</span><span style="position: absolute; left: 138px; top: 153px; color: white; font-style: italic; font-weight: bold; font-size: 13px!important; font-family: Arial, sans-serif;">border-bottom</span><span class="comment">{{mediawiki.external('if IE')}}&gt;&lt;span id="MrgLeft" style="position: absolute; left: 8px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;"&gt;margin-left&lt;/span&gt;&lt;span id="BrdLeft" style="position: absolute; left: 33px; top: 65px; color: white; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;"&gt;border-left&lt;/span&gt;&lt;span id="PdgLeft" style="position: absolute; left: 55px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;"&gt;padding-left&lt;/span&gt;&lt;span id="PdgRight" style="position: absolute; left: 275px; top: 60px; color: black; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl; white-space: nowrap;"&gt;padding-right&lt;/span&gt;&lt;span id="BrdRight" style="position: absolute; left: 310px; top: 65px; color: white; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;"&gt;border-right&lt;/span&gt;&lt;span id="MrgRight" style="position: absolute; left: 340px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;"&gt;margin-right&lt;/span&gt;&lt;!{{mediawiki.external('endif')}}</span></div>
<p style="margin-top: 270px;"><img alt="Image:clientWidth.png" src="File:en/Media_Gallery/ClientWidth.png"></p>
<h3 name="Specification">Specification</h3>
<p>clientWidth is part of the MSIE's {{template.Abbr("DHTML", "Dynamic HyperText Markup Language")}} object model.
clientWidth is not part of any W3C specification or technical recommendation.
</p>
<h3 name="Notes">Notes</h3>
<p>clientWidth is a property of the {{template.Abbr("DHTML", "Dynamic HyperText Markup Language")}} object model which was first introduced by MSIE. It represents the inner width of an element.
</p>
<h3 name="References">References</h3>
<ul><li> <a class="external" href="http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/clientwidth.asp?frame=true">MSDN's clientWidth definition</a>
</li><li> <a class="external" href="http://msdn.microsoft.com/workshop/author/om/measuring.asp">MSDN's Measuring Element Dimension and Location</a>
</li><li> <a class="external" href="http://www.mozilla.org/docs/dom/domref/clientWidth.html">Gecko DOM Reference on clientWidth</a>
</li></ul>
Revert to this revision