diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:41:15 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:41:15 -0500 |
commit | 4b1a9203c547c019fc5398082ae19a3f3d4c3efe (patch) | |
tree | d4a40e13ceeb9f85479605110a76e7a4d5f3b56b /files/de/web/api/range | |
parent | 33058f2b292b3a581333bdfb21b8f671898c5060 (diff) | |
download | translated-content-4b1a9203c547c019fc5398082ae19a3f3d4c3efe.tar.gz translated-content-4b1a9203c547c019fc5398082ae19a3f3d4c3efe.tar.bz2 translated-content-4b1a9203c547c019fc5398082ae19a3f3d4c3efe.zip |
initial commit
Diffstat (limited to 'files/de/web/api/range')
-rw-r--r-- | files/de/web/api/range/index.html | 254 | ||||
-rw-r--r-- | files/de/web/api/range/range/index.html | 95 |
2 files changed, 349 insertions, 0 deletions
diff --git a/files/de/web/api/range/index.html b/files/de/web/api/range/index.html new file mode 100644 index 0000000000..2dd5008afc --- /dev/null +++ b/files/de/web/api/range/index.html @@ -0,0 +1,254 @@ +--- +title: Range +slug: Web/API/Range +tags: + - API + - DOM + - NeedsTranslation + - TopicStub +translation_of: Web/API/Range +--- +<p>{{ APIRef("DOM") }}</p> + +<p>The <strong><code>Range</code></strong> interface represents a fragment of a document that can contain nodes and parts of text nodes.</p> + +<p>A range can be created using the {{ domxref("Document.createRange", "createRange()") }} method of the {{ domxref("Document") }} object. Range objects can also be retrieved by using the {{ domxref("Selection/getRangeAt", "getRangeAt()") }} method of the {{ domxref("Selection") }} object or the {{domxref("Document/caretRangeFromPoint", "caretRangeAtPoint()")}} method of the {{domxref("Document")}} object.</p> + +<p>There also is the {{domxref("Range.Range()", "Range()")}} constructor available.</p> + +<h2 id="Properties" name="Properties">Properties</h2> + +<p><em>There are no inherited properties.</em></p> + +<dl> + <dt>{{domxref("Range.collapsed")}} {{readonlyInline}}</dt> + <dd>Returns a {{domxref("Boolean")}} indicating whether the range's start and end points are at the same position.</dd> + <dt>{{domxref("Range.commonAncestorContainer")}} {{readonlyInline}}</dt> + <dd>Returns the deepest {{ domxref("Node") }} that contains the <code>startContainer</code> and <code>endContainer</code> nodes.</dd> + <dt>{{domxref("Range.endContainer")}} {{readonlyInline}}</dt> + <dd>Returns the {{ domxref("Node") }} within which the <code>Range</code> ends.</dd> + <dt>{{domxref("Range.endOffset")}} {{readonlyInline}}</dt> + <dd>Returns a number representing where in the <code>endContainer</code> the <code>Range</code> ends.</dd> + <dt>{{domxref("Range.startContainer")}} {{readonlyInline}}</dt> + <dd>Returns the {{ domxref("Node") }} within which the <code>Range</code> starts.</dd> + <dt>{{domxref("Range.startOffset")}} {{readonlyInline}}</dt> + <dd>Returns a number representing where in the <code>startContainer</code> the <code>Range</code> starts.</dd> +</dl> + +<h2 id="Constructor">Constructor</h2> + +<dl> + <dt>{{ domxref("Range.Range()", "Range()") }} {{experimental_inline}}</dt> + <dd>Returns a <code>Range</code> object with the global {{domxref("Document")}} as its start and end.</dd> +</dl> + +<h2 id="Methods" name="Methods">Methods</h2> + +<p><em>There are no inherited methods.</em></p> + +<dl> + <dt>{{ domxref("Range.setStart()")}}</dt> + <dd>Sets the start position of a <code>Range</code>.</dd> + <dt>{{ domxref("Range.setEnd()")}}</dt> + <dd>Sets the end position of a <code>Range</code>.</dd> + <dt>{{ domxref("Range.setStartBefore()")}}</dt> + <dd>Sets the start position of a <code>Range</code> relative to another {{ domxref("Node") }}.</dd> + <dt>{{ domxref("Range.setStartAfter()")}}</dt> + <dd>Sets the start position of a <code>Range</code> relative to another {{ domxref("Node") }}.</dd> + <dt>{{ domxref("Range.setEndBefore()")}}</dt> + <dd>Sets the end position of a <code>Range</code> relative to another {{ domxref("Node") }}.</dd> + <dt>{{ domxref("Range.setEndAfter()")}}</dt> + <dd>Sets the end position of a <code>Range</code> relative to another {{ domxref("Node") }}.</dd> + <dt>{{ domxref("Range.selectNode()")}}</dt> + <dd>Sets the <code>Range</code> to contain the {{ domxref("Node") }} and its contents.</dd> + <dt>{{ domxref("Range.selectNodeContents()")}}</dt> + <dd>Sets the <code>Range</code> to contain the contents of a {{ domxref("Node") }}.</dd> + <dt>{{ domxref("Range.collapse()")}}</dt> + <dd>Collapses the <code>Range</code> to one of its boundary points.</dd> + <dt>{{ domxref("Range.cloneContents()")}}</dt> + <dd>Returns a {{ domxref("DocumentFragment") }} copying the nodes of a <code>Range</code>.</dd> + <dt>{{ domxref("Range.deleteContents()")}}</dt> + <dd>Removes the contents of a <code>Range</code> from the {{ domxref("Document") }}.</dd> + <dt>{{ domxref("Range.extractContents()")}}</dt> + <dd>Moves contents of a <code>Range</code> from the document tree into a {{ domxref("DocumentFragment") }}.</dd> + <dt>{{ domxref("Range.insertNode()")}}</dt> + <dd>Insert a {{ domxref("Node") }} at the start of a <code>Range</code>.</dd> + <dt>{{ domxref("Range.surroundContents()")}}</dt> + <dd>Moves content of a <code>Range</code> into a new {{ domxref("Node") }}.</dd> + <dt>{{ domxref("Range.compareBoundaryPoints()")}}</dt> + <dd>Compares the boundary points of the <code>Range</code> with another <code>Range</code>.</dd> + <dt>{{ domxref("Range.cloneRange()")}}</dt> + <dd>Returns a <code>Range</code> object with boundary points identical to the cloned <code>Range</code>.</dd> + <dt>{{ domxref("Range.detach()")}}</dt> + <dd>Releases the <code>Range</code> from use to improve performance.</dd> + <dt>{{ domxref("Range.toString()")}}</dt> + <dd>Returns the text of the <code>Range</code>.</dd> + <dt>{{ domxref("Range.compareNode()")}} {{ Obsolete_inline }}{{non-standard_inline}}</dt> + <dd>Returns a constant representing whether the {{domxref("Node")}} is before, after, inside, or surrounding the range.</dd> + <dt>{{ domxref("Range.comparePoint()")}} {{experimental_inline}}</dt> + <dd>Returns -1, 0, or 1 indicating whether the point occurs before, inside, or after the <code>Range</code>.</dd> + <dt>{{ domxref("Range.createContextualFragment()")}}{{experimental_inline}}</dt> + <dd>Returns a {{ domxref("DocumentFragment") }} created from a given string of code.</dd> + <dt>{{ domxref("Range.getBoundingClientRect()") }} {{experimental_inline}}</dt> + <dd>Returns a {{ domxref("DOMRect") }} object which bounds the entire contents of the <code>Range</code>; this would be the union of all the rectangles returned by {{ domxref("range.getClientRects()") }}.</dd> + <dt>{{ domxref("Range.getClientRects()") }} {{experimental_inline}}</dt> + <dd>Returns a list of {{ domxref("DOMRect") }} objects that aggregates the results of {{ domxref("Element.getClientRects()") }} for all the elements in the <code>Range</code>.</dd> + <dt>{{ domxref("Range.intersectsNode()")}} {{experimental_inline}}</dt> + <dd>Returns a <code>boolean</code> indicating whether the given node intersects the <code>Range</code>.</dd> + <dt>{{ domxref("Range.isPointInRange()")}} {{experimental_inline}}</dt> + <dd>Returns a <code>boolean</code> indicating whether the given point is in the <code>Range</code>.</dd> +</dl> + +<h2 id="Specifications">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', '#interface-range', 'Range')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Do not use <code>RangeException</code> anymore, use <code>DOMException</code> instead.<br> + Made the second parameter of <code>collapse()</code> optional.<br> + Added the methods <code>isPointInRange()</code>, <code>comparePoint()</code>, and <code>intersectsNode()</code>.<br> + Added the constructor <code>Range()</code>.</td> + </tr> + <tr> + <td>{{SpecName('DOM Parsing', '#extensions-to-the-range-interface', 'Extensions to Range')}}</td> + <td>{{Spec2('DOM Parsing')}}</td> + <td>Added the method <code>createContextualFragment()</code>.</td> + </tr> + <tr> + <td>{{SpecName('CSSOM View', '#extensions-to-the-range-interface', 'Extensions to Range')}}</td> + <td>{{Spec2('CSSOM View')}}</td> + <td>Added the methods <code>getClientRects()</code> and <code>getBoundingClientRect()</code>.</td> + </tr> + <tr> + <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level-2-Range-Interface', 'Range')}}</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>Edge</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>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("1.0")}} [1]</td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + <tr> + <td><code>Range()</code> constructor {{experimental_inline}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("24.0")}}</td> + <td>{{CompatNo}}</td> + <td>15.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + <tr> + <td><code>compareNode()</code> {{obsolete_inline}}{{non-standard_inline()}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("1.0")}}<br> + Removed in {{CompatGeckoDesktop("1.9")}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + <tr> + <td><code>isPointInRange()</code>, and <code>comparePoint()</code>{{experimental_inline}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatNo}}</td> + <td>15.0</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>intersectsNode()</code> {{experimental_inline}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("17.0")}} [2]</td> + <td>{{CompatNo}}</td> + <td>15.0</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>getClientRects()</code> and <code>getBoundingClientRect()</code>{{experimental_inline}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("2.0")}}</td> + <td>9</td> + <td>15.0</td> + <td>5</td> + </tr> + <tr> + <td><code>createContextualFragment()</code>{{experimental_inline}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>11</td> + <td>15.0</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Edge</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>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("1.0")}} [1]</td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] Starting with Gecko 13.0 {{ geckoRelease("13.0") }} the <code>Range</code> object throws a {{ domxref("DOMException") }} as defined in DOM 4, instead of a <code>RangeException</code> defined in prior specifications.</p> + +<p>[2] Gecko supported it up to Gecko 1.9, then removed it until Gecko 17 where it was reimplemented, matching the spec.</p> + +<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> diff --git a/files/de/web/api/range/range/index.html b/files/de/web/api/range/range/index.html new file mode 100644 index 0000000000..f4dddfe830 --- /dev/null +++ b/files/de/web/api/range/range/index.html @@ -0,0 +1,95 @@ +--- +title: Range() +slug: Web/API/Range/Range +translation_of: Web/API/Range/Range +--- +<p>{{ APIRef("DOM") }}{{seeCompatTable}}</p> + +<p>Der <code><strong>Range()</strong></code> Konstrukteur gibt ein neu generiertes Objekt wieder, wessen Start und Ende das globale {{domxref("Document")}} Objekt ist.</p> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox"><em>range</em> = new Range()</pre> + +<h2 id="Beispiele">Beispiele</h2> + +<pre class="brush: js language-js"><code class="language-js">range <span class="operator token">=</span> new <span class="function token">Range<span class="punctuation token">(</span></span><span class="punctuation token">)</span><span class="punctuation token">;</span> +endNode <span class="operator token">=</span> document<span class="punctuation token">.</span><span class="function token">getElementsByTagName<span class="punctuation token">(</span></span><span class="string token">"p"</span><span class="punctuation token">)</span><span class="punctuation token">.</span><span class="function token">item<span class="punctuation token">(</span></span><span class="number token">3</span><span class="punctuation token">)</span><span class="punctuation token">;</span> +endOffset <span class="operator token">=</span> document<span class="punctuation token">.</span><span class="function token">getElementsByTagName<span class="punctuation token">(</span></span><span class="string token">"p"</span><span class="punctuation token">)</span><span class="punctuation token">.</span><span class="function token">item<span class="punctuation token">(</span></span><span class="number token">3</span><span class="punctuation token">)</span><span class="punctuation token">.</span>childNodes<span class="punctuation token">.</span>length<span class="punctuation token">;</span> +range<span class="punctuation token">.</span><span class="function token">setEnd<span class="punctuation token">(</span></span>endNode<span class="punctuation token">,</span>endOffset<span class="punctuation token">)</span><span class="punctuation token">;</span></code></pre> + +<h2 id="Specification" name="Specification">Spezifikationen</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spezifikation</th> + <th scope="col">Status</th> + <th scope="col">Kommentar</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-range', 'Range.Range()')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Browserkompatibilität">Browserkompatibilität</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>Basis Unterstützung</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("24.0")}}</td> + <td>{{CompatNo}}</td> + <td>15.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>Basis Unterstützung</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("24.0")}}</td> + <td>{{CompatNo}}</td> + <td>15.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Siehe_auch">Siehe auch</h2> + +<ul> + <li><a href="/en-US/docs/DOM/DOM_Reference" title="/en-US/docs/DOM/DOM_Reference">The DOM interfaces index</a></li> + <li><a href="/en-US/docs/Web/API/Document/createRange">Document.createRange()</a></li> +</ul> + +<p> </p> |