Element.scrollHeight

  • Revision slug: DOM/element.scrollHeight
  • Revision title: element.scrollHeight
  • Revision id: 345439
  • Created:
  • Creator: vyv03354
  • Is current revision? No
  • Comment

Revision Content

{{ DomRef() }}

This property will round the value to an integer. If you need a fractional value, use {{ domxref("element.getBoundingClientRect()") }}.

scrollHeight

Height of the scroll view of an element; it includes the element padding but not its margin.

Syntax and values

var intElemScrollHeight = document.getElementById(id_attribute_value).scrollHeight;

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

Description

An element's scrollHeight is a measurement of the height of an element's content including content not visible on the screen due to overflow.

If the element's content generated a vertical scrollbar, the scrollHeight value is equal to the minimum clientHeight the element would require in order to fit all the content in the viewpoint without using a vertical scrollbar. When an element's content does not generate a vertical scrollbar, then its scrollHeight property is equal to its clientHeight property. This can mean either the content is too short to require a scrollbar or that the the element has CSS style overflow value of visible (non-scrollable).

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: _fckstyle="position: _fckstyle="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:scrollHeight.png

Specification

scrollHeight is part of the MSIE's DHTML object model. scrollHeight is not part of any W3C specification or technical recommendation.

Browser compatibility

Browser Lowest version
Internet Explorer 8.0
Firefox (Gecko) 3.0 (1.9)
Opera ?
Safari | Chrome | WebKit 4.0 | 4.0 | ?

Notes

scrollHeight is a property of the DHTML object model which was first introduced by MSIE. It is referred to as the height of an element's physical scrolling view.

References

  • {{ MSDN("ms534615", "scrollHeight Property") }}
  • {{ MSDN("ms530302", "Measuring Element Dimension and Location") }}

See Also

{{ languages( { "fr": "fr/DOM/element.scrollHeight", "pl": "pl/DOM/element.scrollHeight" } ) }}

Revision Source

<p>{{ DomRef() }}</p>
<div class="note">
<p>This property will round the value to an integer. If you need a fractional value, use {{ domxref("element.getBoundingClientRect()") }}.</p>
</div>
<h3 id="scrollHeight" name="scrollHeight">scrollHeight</h3>
<p>Height of the scroll view of an element; it includes the element padding but <strong>not</strong> its margin.</p>
<h3 id="Syntax_and_values" name="Syntax_and_values">Syntax and values</h3>
<pre class="eval">
var <em>intElemScrollHeight</em> = document.getElementById(<em>id_attribute_value</em>).scrollHeight;
</pre>
<p><em>intElemScrollHeight</em> is a variable storing an integer corresponding to the scrollHeight pixel value of the element. scrollHeight is a read-only property.</p>
<h3 id="Description" name="Description">Description</h3>
<p>An element's <strong>scrollHeight</strong> is a measurement of the height of an element's content including content not visible on the screen due to overflow.</p>
<p>If the element's content generated a vertical scrollbar, the <code>scrollHeight</code> value is equal to the minimum <code>clientHeight</code> the element would require in order to fit all the content in the viewpoint without using a vertical scrollbar. When an element's content does not generate a vertical scrollbar, then its <code>scrollHeight</code> property is equal to its <code>clientHeight</code> property. This can mean either the content is too short to require a scrollbar or that the the element has CSS style overflow value of visible (non-scrollable).</p>
<h3 id="Example" 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" class="internal" src="/@api/deki/files/44/=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: -24px; 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: _fckstyle="position: _fckstyle="position: absolute; left: 8px; top: 65px; font: bold 13px Arial, sans-serif&nbsp;!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&nbsp;!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&nbsp;!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&nbsp;!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&nbsp;!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&nbsp;!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:scrollHeight.png" class="internal" src="/@api/deki/files/840/=ScrollHeight.png" /></p>
<h3 id="Specification" name="Specification">Specification</h3>
<p><code>scrollHeight</code> is part of the MSIE's <abbr title="Dynamic HyperText Markup Language">DHTML</abbr> object model. <code>scrollHeight</code> is not part of any W3C specification or technical recommendation.</p>
<h3 id="Supported" name="Supported">Browser compatibility</h3>
<table class="standard-table">
  <tbody>
    <tr>
      <th>Browser</th>
      <th>Lowest version</th>
    </tr>
    <tr>
      <td>Internet Explorer</td>
      <td><strong>8.0</strong></td>
    </tr>
    <tr>
      <td>Firefox (Gecko)</td>
      <td><strong>3.0</strong> (1.9)</td>
    </tr>
    <tr>
      <td>Opera</td>
      <td>?</td>
    </tr>
    <tr>
      <td>Safari | Chrome | WebKit</td>
      <td><strong>4.0</strong> | <strong>4.0</strong> | ?</td>
    </tr>
  </tbody>
</table>
<h3 id="Notes">Notes</h3>
<p><code>scrollHeight</code> is a property of the <abbr title="Dynamic HyperText Markup Language">DHTML</abbr> object model which was first introduced by MSIE. It is referred to as the height of an element's physical scrolling view.</p>
<h3 id="References" name="References">References</h3>
<ul>
  <li>{{ MSDN("ms534615", "scrollHeight Property") }}</li>
  <li>{{ MSDN("ms530302", "Measuring Element Dimension and Location") }}</li>
</ul>
<h3 id="See_Also" name="See_Also">See Also</h3>
<ul>
  <li><a href="/en/DOM/element.clientHeight" title="en/DOM/element.clientHeight">DOM:element.clientHeight</a></li>
  <li><a href="/en/DOM/element.offsetHeight" title="en/DOM/element.offsetHeight">DOM:element.offsetHeight</a></li>
  <li><a href="/en/Determining_the_dimensions_of_elements" title="en/Determining_the_dimensions_of_elements">Determining the dimensions of elements</a></li>
</ul>
<p>{{ languages( { "fr": "fr/DOM/element.scrollHeight", "pl": "pl/DOM/element.scrollHeight" } ) }}</p>
Revert to this revision