Range.selectNodeContents

  • Revision slug: Web/API/range.selectNodeContents
  • Revision title: Range.selectNodeContents
  • Revision id: 471601
  • Created:
  • Creator: Khodaidad_Basharmand
  • Is current revision? Yes
  • Comment

Revision Content

{{ DomRef("Range") }}

The Range.selectNodeContents() sets the {{ domxref("Range") }} to contain the contents of a {{ domxref("Node") }}.

The parent {{ domxref("Node") }} of the start and end of the {{ domxref("Range") }} will be the reference node. The startOffset is 0, and the endOffset is the number of child Nodes or number of characters contained in the reference node.

Syntax

range.selectNodeContents(referenceNode);

Parameters

referenceNode
The {{ domxref("Node") }} whose contents will be selected within a {{ domxref("Range") }}.

Example

range = document.createRange();
referenceNode = document.getElementsByTagName("div")[0];
range.selectNodeContents(referenceNode);

Specifications

Specification Status Comment
{{SpecName('DOM WHATWG', '#dom-range-selectnodecontents', 'Range.selectNodeContents()')}} {{Spec2('DOM WHATWG')}} No change.
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-selectNodeContents', 'Range.selectNodeContents()')}} {{Spec2('DOM2 Traversal_Range')}} Initial specification.

Browser compatibility

{{CompatibilityTable}}

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support {{CompatVersionUnknown}} {{CompatGeckoDesktop("1.0")}} 9.0 9.0 {{CompatVersionUnknown}}
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support {{CompatVersionUnknown}} {{CompatGeckoMobile("1.0")}} 9.0 9.0 {{CompatVersionUnknown}}

See also

Revision Source

<p>{{ DomRef("Range") }}</p>
<p>The <strong><code>Range.selectNodeContents()</code></strong> sets the&nbsp;{{ domxref("Range") }}&nbsp;to contain the contents of a&nbsp;{{ domxref("Node") }}.</p>
<p>The parent&nbsp;{{ domxref("Node") }}&nbsp;of the start and end of the {{ domxref("Range") }}&nbsp;will be the reference node. The <code>startOffset</code> is 0, and the <code>endOffset</code> is the number of child <code>Nodes</code> or number of characters contained in the reference node.</p>
<h2 id="Syntax" name="Syntax">Syntax</h2>
<pre class="syntaxbox">
<em>range</em>.selectNodeContents(<em>referenceNode</em>);
</pre>
<h3 id="Parameters" name="Parameters">Parameters</h3>
<dl>
  <dt>
    <em>referenceNode</em></dt>
  <dd>
    The&nbsp;{{ domxref("Node") }}&nbsp;whose contents will be selected within a&nbsp;{{ domxref("Range") }}.</dd>
</dl>
<h2 id="Example" name="Example">Example</h2>
<pre class="brush: js">
range = document.createRange();
referenceNode = document.getElementsByTagName("div")[0];
range.selectNodeContents(referenceNode);
</pre>
<h2 id="Specification" name="Specification">Specifications</h2>
<table class="standard-table">
  <tbody>
    <tr>
      <th scope="col">Specification</th>
      <th scope="col">Status</th>
      <th scope="col">Comment</th>
    </tr>
    <tr>
      <td>{{SpecName('DOM WHATWG', '#dom-range-selectnodecontents', 'Range.selectNodeContents()')}}</td>
      <td>{{Spec2('DOM WHATWG')}}</td>
      <td>No change.</td>
    </tr>
    <tr>
      <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-selectNodeContents', 'Range.selectNodeContents()')}}</td>
      <td>{{Spec2('DOM2 Traversal_Range')}}</td>
      <td>Initial specification.</td>
    </tr>
  </tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Feature</th>
        <th>Chrome</th>
        <th>Firefox (Gecko)</th>
        <th>Internet Explorer</th>
        <th>Opera</th>
        <th>Safari</th>
      </tr>
      <tr>
        <td>Basic support</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatGeckoDesktop("1.0")}}</td>
        <td>9.0</td>
        <td>9.0</td>
        <td>{{CompatVersionUnknown}}</td>
      </tr>
    </tbody>
  </table>
</div>
<div id="compat-mobile">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Feature</th>
        <th>Android</th>
        <th>Firefox Mobile (Gecko)</th>
        <th>IE Mobile</th>
        <th>Opera Mobile</th>
        <th>Safari Mobile</th>
      </tr>
      <tr>
        <td>Basic support</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatGeckoMobile("1.0")}}</td>
        <td>9.0</td>
        <td>9.0</td>
        <td>{{CompatVersionUnknown}}</td>
      </tr>
    </tbody>
  </table>
</div>
<h2 id="See_also">See also</h2>
<ul>
  <li><a href="/en-US/docs/DOM/DOM_Reference" title="/en-US/docs/DOM/DOM_Reference">The DOM interfaces index</a></li>
</ul>
Revert to this revision