diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt index 7addb0f93f2f1da..b80540cc64033ed 100644 --- a/files/en-us/_redirects.txt +++ b/files/en-us/_redirects.txt @@ -1990,7 +1990,7 @@ /en-US/docs/DOM/range.cloneContents /en-US/docs/Web/API/Range/cloneContents /en-US/docs/DOM/range.cloneRange /en-US/docs/Web/API/Range/cloneRange /en-US/docs/DOM/range.collapse /en-US/docs/Web/API/Range/collapse -/en-US/docs/DOM/range.collapsed /en-US/docs/Web/API/Range/collapsed +/en-US/docs/DOM/range.collapsed /en-US/docs/Web/API/AbstractRange/collapsed /en-US/docs/DOM/range.commonAncestorContainer /en-US/docs/Web/API/Range/commonAncestorContainer /en-US/docs/DOM/range.compareBoundaryPoints /en-US/docs/Web/API/Range/compareBoundaryPoints /en-US/docs/DOM/range.compareNode /en-US/docs/Web/API/Range/compareNode @@ -1998,8 +1998,8 @@ /en-US/docs/DOM/range.createContextualFragment /en-US/docs/Web/API/Range/createContextualFragment /en-US/docs/DOM/range.deleteContents /en-US/docs/Web/API/Range/deleteContents /en-US/docs/DOM/range.detach /en-US/docs/Web/API/Range/detach -/en-US/docs/DOM/range.endContainer /en-US/docs/Web/API/Range/endContainer -/en-US/docs/DOM/range.endOffset /en-US/docs/Web/API/Range/endOffset +/en-US/docs/DOM/range.endContainer /en-US/docs/Web/API/AbstractRange/endContainer +/en-US/docs/DOM/range.endOffset /en-US/docs/Web/API/AbstractRange/endOffset /en-US/docs/DOM/range.extractContents /en-US/docs/Web/API/Range/extractContents /en-US/docs/DOM/range.getBoundingClientRect /en-US/docs/Web/API/Range/getBoundingClientRect /en-US/docs/DOM/range.getClientRects /en-US/docs/Web/API/Range/getClientRects @@ -2014,8 +2014,8 @@ /en-US/docs/DOM/range.setStart /en-US/docs/Web/API/Range/setStart /en-US/docs/DOM/range.setStartAfter /en-US/docs/Web/API/Range/setStartAfter /en-US/docs/DOM/range.setStartBefore /en-US/docs/Web/API/Range/setStartBefore -/en-US/docs/DOM/range.startContainer /en-US/docs/Web/API/Range/startContainer -/en-US/docs/DOM/range.startOffset /en-US/docs/Web/API/Range/startOffset +/en-US/docs/DOM/range.startContainer /en-US/docs/Web/API/AbstractRange/startContainer +/en-US/docs/DOM/range.startOffset /en-US/docs/Web/API/AbstractRange/startOffset /en-US/docs/DOM/range.surroundContents /en-US/docs/Web/API/Range/surroundContents /en-US/docs/DOM/range.toString /en-US/docs/Web/API/Range/toString /en-US/docs/DOM/select.type /en-US/docs/Web/API/HTMLSelectElement/type @@ -2467,7 +2467,7 @@ /en-US/docs/DOM:range.cloneContents /en-US/docs/Web/API/Range/cloneContents /en-US/docs/DOM:range.cloneRange /en-US/docs/Web/API/Range/cloneRange /en-US/docs/DOM:range.collapse /en-US/docs/Web/API/Range/collapse -/en-US/docs/DOM:range.collapsed /en-US/docs/Web/API/Range/collapsed +/en-US/docs/DOM:range.collapsed /en-US/docs/Web/API/AbstractRange/collapsed /en-US/docs/DOM:range.commonAncestorContainer /en-US/docs/Web/API/Range/commonAncestorContainer /en-US/docs/DOM:range.compareBoundaryPoints /en-US/docs/Web/API/Range/compareBoundaryPoints /en-US/docs/DOM:range.compareNode /en-US/docs/Web/API/Range/compareNode @@ -2475,8 +2475,8 @@ /en-US/docs/DOM:range.createContextualFragment /en-US/docs/Web/API/Range/createContextualFragment /en-US/docs/DOM:range.deleteContents /en-US/docs/Web/API/Range/deleteContents /en-US/docs/DOM:range.detach /en-US/docs/Web/API/Range/detach -/en-US/docs/DOM:range.endContainer /en-US/docs/Web/API/Range/endContainer -/en-US/docs/DOM:range.endOffset /en-US/docs/Web/API/Range/endOffset +/en-US/docs/DOM:range.endContainer /en-US/docs/Web/API/AbstractRange/endContainer +/en-US/docs/DOM:range.endOffset /en-US/docs/Web/API/AbstractRange/endOffset /en-US/docs/DOM:range.extractContents /en-US/docs/Web/API/Range/extractContents /en-US/docs/DOM:range.insertNode /en-US/docs/Web/API/Range/insertNode /en-US/docs/DOM:range.intersectsNode /en-US/docs/Web/API/Range/intersectsNode @@ -2489,8 +2489,8 @@ /en-US/docs/DOM:range.setStart /en-US/docs/Web/API/Range/setStart /en-US/docs/DOM:range.setStartAfter /en-US/docs/Web/API/Range/setStartAfter /en-US/docs/DOM:range.setStartBefore /en-US/docs/Web/API/Range/setStartBefore -/en-US/docs/DOM:range.startContainer /en-US/docs/Web/API/Range/startContainer -/en-US/docs/DOM:range.startOffset /en-US/docs/Web/API/Range/startOffset +/en-US/docs/DOM:range.startContainer /en-US/docs/Web/API/AbstractRange/startContainer +/en-US/docs/DOM:range.startOffset /en-US/docs/Web/API/AbstractRange/startOffset /en-US/docs/DOM:range.surroundContents /en-US/docs/Web/API/Range/surroundContents /en-US/docs/DOM:range.toString /en-US/docs/Web/API/Range/toString /en-US/docs/DOM:style.media /en-US/docs/Web/API/HTMLStyleElement/media @@ -3190,15 +3190,15 @@ /en-US/docs/Document_Object_Model_(DOM)/range.cloneContents /en-US/docs/Web/API/Range/cloneContents /en-US/docs/Document_Object_Model_(DOM)/range.cloneRange /en-US/docs/Web/API/Range/cloneRange /en-US/docs/Document_Object_Model_(DOM)/range.collapse /en-US/docs/Web/API/Range/collapse -/en-US/docs/Document_Object_Model_(DOM)/range.collapsed /en-US/docs/Web/API/Range/collapsed +/en-US/docs/Document_Object_Model_(DOM)/range.collapsed /en-US/docs/Web/API/AbstractRange/collapsed /en-US/docs/Document_Object_Model_(DOM)/range.commonAncestorContainer /en-US/docs/Web/API/Range/commonAncestorContainer /en-US/docs/Document_Object_Model_(DOM)/range.compareBoundaryPoints /en-US/docs/Web/API/Range/compareBoundaryPoints /en-US/docs/Document_Object_Model_(DOM)/range.compareNode /en-US/docs/Web/API/Range/compareNode /en-US/docs/Document_Object_Model_(DOM)/range.comparePoint /en-US/docs/Web/API/Range/comparePoint /en-US/docs/Document_Object_Model_(DOM)/range.createContextualFragment /en-US/docs/Web/API/Range/createContextualFragment /en-US/docs/Document_Object_Model_(DOM)/range.deleteContents /en-US/docs/Web/API/Range/deleteContents -/en-US/docs/Document_Object_Model_(DOM)/range.endContainer /en-US/docs/Web/API/Range/endContainer -/en-US/docs/Document_Object_Model_(DOM)/range.endOffset /en-US/docs/Web/API/Range/endOffset +/en-US/docs/Document_Object_Model_(DOM)/range.endContainer /en-US/docs/Web/API/AbstractRange/endContainer +/en-US/docs/Document_Object_Model_(DOM)/range.endOffset /en-US/docs/Web/API/AbstractRange/endOffset /en-US/docs/Document_Object_Model_(DOM)/range.extractContents /en-US/docs/Web/API/Range/extractContents /en-US/docs/Document_Object_Model_(DOM)/range.getBoundingClientRect /en-US/docs/Web/API/Range/getBoundingClientRect /en-US/docs/Document_Object_Model_(DOM)/range.getClientRects /en-US/docs/Web/API/Range/getClientRects @@ -3212,8 +3212,8 @@ /en-US/docs/Document_Object_Model_(DOM)/range.setStart /en-US/docs/Web/API/Range/setStart /en-US/docs/Document_Object_Model_(DOM)/range.setStartAfter /en-US/docs/Web/API/Range/setStartAfter /en-US/docs/Document_Object_Model_(DOM)/range.setStartBefore /en-US/docs/Web/API/Range/setStartBefore -/en-US/docs/Document_Object_Model_(DOM)/range.startContainer /en-US/docs/Web/API/Range/startContainer -/en-US/docs/Document_Object_Model_(DOM)/range.startOffset /en-US/docs/Web/API/Range/startOffset +/en-US/docs/Document_Object_Model_(DOM)/range.startContainer /en-US/docs/Web/API/AbstractRange/startContainer +/en-US/docs/Document_Object_Model_(DOM)/range.startOffset /en-US/docs/Web/API/AbstractRange/startOffset /en-US/docs/Document_Object_Model_(DOM)/range.surroundContents /en-US/docs/Web/API/Range/surroundContents /en-US/docs/Document_Object_Model_(DOM)/range.toString /en-US/docs/Web/API/Range/toString /en-US/docs/Document_Object_Model_(DOM)/select.type /en-US/docs/Web/API/HTMLSelectElement/type @@ -6924,7 +6924,7 @@ /en-US/docs/Range/cloneContents /en-US/docs/Web/API/Range/cloneContents /en-US/docs/Range/cloneRange /en-US/docs/Web/API/Range/cloneRange /en-US/docs/Range/collapse /en-US/docs/Web/API/Range/collapse -/en-US/docs/Range/collapsed /en-US/docs/Web/API/Range/collapsed +/en-US/docs/Range/collapsed /en-US/docs/Web/API/AbstractRange/collapsed /en-US/docs/Range/commonAncestorContainer /en-US/docs/Web/API/Range/commonAncestorContainer /en-US/docs/Range/compareBoundaryPoints /en-US/docs/Web/API/Range/compareBoundaryPoints /en-US/docs/Range/compareNode /en-US/docs/Web/API/Range/compareNode @@ -6932,8 +6932,8 @@ /en-US/docs/Range/createContextualFragment /en-US/docs/Web/API/Range/createContextualFragment /en-US/docs/Range/deleteContents /en-US/docs/Web/API/Range/deleteContents /en-US/docs/Range/detach /en-US/docs/Web/API/Range/detach -/en-US/docs/Range/endContainer /en-US/docs/Web/API/Range/endContainer -/en-US/docs/Range/endOffset /en-US/docs/Web/API/Range/endOffset +/en-US/docs/Range/endContainer /en-US/docs/Web/API/AbstractRange/endContainer +/en-US/docs/Range/endOffset /en-US/docs/Web/API/AbstractRange/endOffset /en-US/docs/Range/extractContents /en-US/docs/Web/API/Range/extractContents /en-US/docs/Range/getBoundingClientRect /en-US/docs/Web/API/Range/getBoundingClientRect /en-US/docs/Range/getClientRects /en-US/docs/Web/API/Range/getClientRects @@ -6948,8 +6948,8 @@ /en-US/docs/Range/setStart /en-US/docs/Web/API/Range/setStart /en-US/docs/Range/setStartAfter /en-US/docs/Web/API/Range/setStartAfter /en-US/docs/Range/setStartBefore /en-US/docs/Web/API/Range/setStartBefore -/en-US/docs/Range/startContainer /en-US/docs/Web/API/Range/startContainer -/en-US/docs/Range/startOffset /en-US/docs/Web/API/Range/startOffset +/en-US/docs/Range/startContainer /en-US/docs/Web/API/AbstractRange/startContainer +/en-US/docs/Range/startOffset /en-US/docs/Web/API/AbstractRange/startOffset /en-US/docs/Range/surroundContents /en-US/docs/Web/API/Range/surroundContents /en-US/docs/Range/toString /en-US/docs/Web/API/Range/toString /en-US/docs/ReadableStream /en-US/docs/Web/API/ReadableStream @@ -10121,6 +10121,11 @@ /en-US/docs/Web/API/Range() /en-US/docs/Web/API/Range/Range /en-US/docs/Web/API/Range.Range /en-US/docs/Web/API/Range/Range /en-US/docs/Web/API/Range.Range() /en-US/docs/Web/API/Range/Range +/en-US/docs/Web/API/Range/collapsed /en-US/docs/Web/API/AbstractRange/collapsed +/en-US/docs/Web/API/Range/endContainer /en-US/docs/Web/API/AbstractRange/endContainer +/en-US/docs/Web/API/Range/endOffset /en-US/docs/Web/API/AbstractRange/endOffset +/en-US/docs/Web/API/Range/startContainer /en-US/docs/Web/API/AbstractRange/startContainer +/en-US/docs/Web/API/Range/startOffset /en-US/docs/Web/API/AbstractRange/startOffset /en-US/docs/Web/API/ReadableByteStream /en-US/docs/Web/API/ReadableStream /en-US/docs/Web/API/Reference /en-US/docs/Web/API /en-US/docs/Web/API/RegisterProperty /en-US/docs/Web/API/CSS/registerProperty_static @@ -10344,6 +10349,11 @@ /en-US/docs/Web/API/SpeechSynthesisUtterance/onpause /en-US/docs/Web/API/SpeechSynthesisUtterance/pause_event /en-US/docs/Web/API/SpeechSynthesisUtterance/onresume /en-US/docs/Web/API/SpeechSynthesisUtterance/resume_event /en-US/docs/Web/API/SpeechSynthesisUtterance/onstart /en-US/docs/Web/API/SpeechSynthesisUtterance/start_event +/en-US/docs/Web/API/StaticRange/collapsed /en-US/docs/Web/API/AbstractRange/collapsed +/en-US/docs/Web/API/StaticRange/endContainer /en-US/docs/Web/API/AbstractRange/endContainer +/en-US/docs/Web/API/StaticRange/endOffset /en-US/docs/Web/API/AbstractRange/endOffset +/en-US/docs/Web/API/StaticRange/startContainer /en-US/docs/Web/API/AbstractRange/startContainer +/en-US/docs/Web/API/StaticRange/startOffset /en-US/docs/Web/API/AbstractRange/startOffset /en-US/docs/Web/API/StereoPannerNode.pan /en-US/docs/Web/API/StereoPannerNode/pan /en-US/docs/Web/API/Storage.clear /en-US/docs/Web/API/Storage/clear /en-US/docs/Web/API/Storage.getItem /en-US/docs/Web/API/Storage/getItem @@ -11290,7 +11300,7 @@ /en-US/docs/Web/API/range.cloneContents /en-US/docs/Web/API/Range/cloneContents /en-US/docs/Web/API/range.cloneRange /en-US/docs/Web/API/Range/cloneRange /en-US/docs/Web/API/range.collapse /en-US/docs/Web/API/Range/collapse -/en-US/docs/Web/API/range.collapsed /en-US/docs/Web/API/Range/collapsed +/en-US/docs/Web/API/range.collapsed /en-US/docs/Web/API/AbstractRange/collapsed /en-US/docs/Web/API/range.commonAncestorContainer /en-US/docs/Web/API/Range/commonAncestorContainer /en-US/docs/Web/API/range.compareBoundaryPoints /en-US/docs/Web/API/Range/compareBoundaryPoints /en-US/docs/Web/API/range.compareNode /en-US/docs/Web/API/Range/compareNode @@ -11298,8 +11308,8 @@ /en-US/docs/Web/API/range.createContextualFragment /en-US/docs/Web/API/Range/createContextualFragment /en-US/docs/Web/API/range.deleteContents /en-US/docs/Web/API/Range/deleteContents /en-US/docs/Web/API/range.detach /en-US/docs/Web/API/Range/detach -/en-US/docs/Web/API/range.endContainer /en-US/docs/Web/API/Range/endContainer -/en-US/docs/Web/API/range.endOffset /en-US/docs/Web/API/Range/endOffset +/en-US/docs/Web/API/range.endContainer /en-US/docs/Web/API/AbstractRange/endContainer +/en-US/docs/Web/API/range.endOffset /en-US/docs/Web/API/AbstractRange/endOffset /en-US/docs/Web/API/range.extractContents /en-US/docs/Web/API/Range/extractContents /en-US/docs/Web/API/range.getBoundingClientRect /en-US/docs/Web/API/Range/getBoundingClientRect /en-US/docs/Web/API/range.getClientRects /en-US/docs/Web/API/Range/getClientRects @@ -11314,8 +11324,8 @@ /en-US/docs/Web/API/range.setStart /en-US/docs/Web/API/Range/setStart /en-US/docs/Web/API/range.setStartAfter /en-US/docs/Web/API/Range/setStartAfter /en-US/docs/Web/API/range.setStartBefore /en-US/docs/Web/API/Range/setStartBefore -/en-US/docs/Web/API/range.startContainer /en-US/docs/Web/API/Range/startContainer -/en-US/docs/Web/API/range.startOffset /en-US/docs/Web/API/Range/startOffset +/en-US/docs/Web/API/range.startContainer /en-US/docs/Web/API/AbstractRange/startContainer +/en-US/docs/Web/API/range.startOffset /en-US/docs/Web/API/AbstractRange/startOffset /en-US/docs/Web/API/range.surroundContents /en-US/docs/Web/API/Range/surroundContents /en-US/docs/Web/API/range.toString /en-US/docs/Web/API/Range/toString /en-US/docs/Web/API/reportError /en-US/docs/Web/API/Window/reportError diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json index e2f38cb1dc519ad..fff224c9bb43b10 100644 --- a/files/en-us/_wikihistory.json +++ b/files/en-us/_wikihistory.json @@ -54253,23 +54253,6 @@ "Gor1" ] }, - "Web/API/Range/collapsed": { - "modified": "2020-10-15T21:17:55.746Z", - "contributors": [ - "mfluehr", - "fscholz", - "abbycar", - "teoli", - "jsx", - "kscarfone", - "Sheppy", - "ethertank", - "DR", - "Mgjbot", - "Maian", - "Jonnyq" - ] - }, "Web/API/Range/commonAncestorContainer": { "modified": "2020-10-15T21:11:04.954Z", "contributors": [ @@ -54389,34 +54372,6 @@ "Gor1" ] }, - "Web/API/Range/endContainer": { - "modified": "2020-10-15T21:18:30.774Z", - "contributors": [ - "fscholz", - "abbycar", - "teoli", - "jsx", - "Khodaidad_Basharmand", - "Sheppy", - "ethertank", - "Jonnyq" - ] - }, - "Web/API/Range/endOffset": { - "modified": "2020-10-15T21:18:27.338Z", - "contributors": [ - "fscholz", - "gnepnaiL-oahZ", - "MarkRusciano", - "abbycar", - "teoli", - "jsx", - "shubham.hatwar", - "Sheppy", - "ethertank", - "Jonnyq" - ] - }, "Web/API/Range/extractContents": { "modified": "2020-10-15T21:09:57.593Z", "contributors": [ @@ -54651,32 +54606,6 @@ "Gor1" ] }, - "Web/API/Range/startContainer": { - "modified": "2020-10-15T21:18:27.123Z", - "contributors": [ - "fscholz", - "abbycar", - "teoli", - "kollishivagangadhar", - "Navin_Jadhav", - "Sheppy", - "Gor1" - ] - }, - "Web/API/Range/startOffset": { - "modified": "2020-10-15T21:18:03.544Z", - "contributors": [ - "fscholz", - "abbycar", - "teoli", - "Brettz9", - "kollishivagangadhar", - "Navin_Jadhav", - "Sheppy", - "Ptak82", - "Gor1" - ] - }, "Web/API/Range/surroundContents": { "modified": "2020-10-15T21:07:29.854Z", "contributors": [ @@ -58809,26 +58738,6 @@ "modified": "2020-10-15T21:59:08.104Z", "contributors": ["Sheppy", "fscholz", "connorshea", "jpmedley"] }, - "Web/API/StaticRange/collapsed": { - "modified": "2020-10-15T21:59:08.677Z", - "contributors": ["Sheppy", "sideshowbarker", "fscholz", "jpmedley"] - }, - "Web/API/StaticRange/endContainer": { - "modified": "2020-10-15T21:59:06.718Z", - "contributors": ["Sheppy", "sideshowbarker", "fscholz", "jpmedley"] - }, - "Web/API/StaticRange/endOffset": { - "modified": "2020-10-15T21:59:05.929Z", - "contributors": ["Sheppy", "sideshowbarker", "fscholz", "jpmedley"] - }, - "Web/API/StaticRange/startContainer": { - "modified": "2020-10-15T21:59:06.036Z", - "contributors": ["Sheppy", "sideshowbarker", "fscholz", "jpmedley"] - }, - "Web/API/StaticRange/startOffset": { - "modified": "2020-10-15T21:59:04.874Z", - "contributors": ["Sheppy", "sideshowbarker", "fscholz", "jpmedley"] - }, "Web/API/StereoPannerNode": { "modified": "2020-10-15T21:32:40.831Z", "contributors": [ diff --git a/files/en-us/web/api/abstractrange/collapsed/index.md b/files/en-us/web/api/abstractrange/collapsed/index.md index d17e3182eb58996..346333587adbf71 100644 --- a/files/en-us/web/api/abstractrange/collapsed/index.md +++ b/files/en-us/web/api/abstractrange/collapsed/index.md @@ -10,6 +10,8 @@ browser-compat: api.AbstractRange.collapsed The read-only **`collapsed`** property of the {{domxref("AbstractRange")}} interface returns `true` if the range's start position and end position are the same. +A collapsed range is empty (containing no content), and specifies a single point in a DOM tree. To collapse a range, see the {{domxref("Range.collapse()")}} method. + ## Value A boolean value which is `true` if the range is _collapsed_. A collapsed range is one in which the start and end positions are the same, resulting in a zero-character-long range. @@ -17,7 +19,11 @@ A boolean value which is `true` if the range is _collapsed_. A collapsed range i ## Example ```js -let isCollapsed = range.collapsed; +const range = document.createRange(); +range.setStart(startNode, startOffset); +range.setEnd(endNode, endOffset); + +const isCollapsed = range.collapsed; ``` ## Specifications diff --git a/files/en-us/web/api/abstractrange/endcontainer/index.md b/files/en-us/web/api/abstractrange/endcontainer/index.md index 0055ccabdbe468d..b0288049d72dcf1 100644 --- a/files/en-us/web/api/abstractrange/endcontainer/index.md +++ b/files/en-us/web/api/abstractrange/endcontainer/index.md @@ -10,6 +10,8 @@ browser-compat: api.AbstractRange.endContainer The read-only **`endContainer`** property of the {{domxref("AbstractRange")}} interface returns the {{domxref("Node")}} in which the end of the range is located. +To change the end position, use the {{domxref("Range.setEnd()")}} method or a similar one. + ## Value The {{domxref("Node")}} which contains the last character of the range. @@ -17,7 +19,11 @@ The {{domxref("Node")}} which contains the last character of the range. ## Example ```js -let endNode = range.endContainer; +const range = document.createRange(); +range.setStart(startNode, startOffset); +range.setEnd(endNode, endOffset); + +const endRangeNode = range.endContainer; ``` ## Specifications diff --git a/files/en-us/web/api/abstractrange/endoffset/index.md b/files/en-us/web/api/abstractrange/endoffset/index.md index 7b6bbf5cac0c585..af09e23bb30a4e4 100644 --- a/files/en-us/web/api/abstractrange/endoffset/index.md +++ b/files/en-us/web/api/abstractrange/endoffset/index.md @@ -10,14 +10,22 @@ browser-compat: api.AbstractRange.endOffset The **`endOffset`** property of the {{domxref("AbstractRange")}} interface returns the offset into the end node of the range's end position. +To change the end position, use the {{domxref("Range.setEnd()")}} method or a similar one. + ## Value An integer value indicating the number of characters into the {{domxref("Node")}} indicated by {{domxref("AbstractRange.endContainer", "endContainer")}} at which the final character of the range is located. +If the `endContainer` is a {{domxref("Node")}} of type {{domxref("Text")}}, {{domxref("Comment")}}, or {{domxref("CDATASection")}}, then the offset is the number of characters from the start of the `endContainer` to the boundary point of the range. For other {{domxref("Node")}} types, the `endOffset` is the number of child nodes between the start of the `endContainer` and the boundary point of the range. + ## Example ```js -let endOffset = range.endOffset; +const range = document.createRange(); +range.setStart(startNode, startOffset); +range.setEnd(endNode, endOffset); + +const endRangeOffset = range.endOffset; ``` ## Specifications diff --git a/files/en-us/web/api/abstractrange/startcontainer/index.md b/files/en-us/web/api/abstractrange/startcontainer/index.md index 445901fac9adab8..a92f84db47e95c9 100644 --- a/files/en-us/web/api/abstractrange/startcontainer/index.md +++ b/files/en-us/web/api/abstractrange/startcontainer/index.md @@ -8,7 +8,9 @@ browser-compat: api.AbstractRange.startContainer {{APIRef("DOM")}} -The read-only **`startContainer`** property of the {{domxref("AbstractRange")}} interface returns the start {{domxref("Node")}} for the range. +The read-only **`startContainer`** property of the {{domxref("AbstractRange")}} interface returns the {{domxref("Node")}} in which the start of the range is located. + +To change the start position, use the {{domxref("Range.setStart()")}} method or a similar one. ## Value @@ -17,7 +19,11 @@ The {{domxref("Node")}} inside which the start position of the range is found. ## Example ```js -let startNode = range.startContainer; +const range = document.createRange(); +range.setStart(startNode, startOffset); +range.setEnd(endNode, endOffset); + +const startRangeNode = range.startContainer; ``` ## Specifications diff --git a/files/en-us/web/api/abstractrange/startoffset/index.md b/files/en-us/web/api/abstractrange/startoffset/index.md index 8514c7cd0508a69..60fbf4738545824 100644 --- a/files/en-us/web/api/abstractrange/startoffset/index.md +++ b/files/en-us/web/api/abstractrange/startoffset/index.md @@ -10,14 +10,22 @@ browser-compat: api.AbstractRange.startOffset The read-only **`startOffset`** property of the {{domxref("AbstractRange")}} interface returns the offset into the start node of the range's start position. +To change the start position, use the {{domxref("Range.setStart()")}} method or a similar one. + ## Value An integer value indicating the number of characters into the {{domxref("Node")}} indicated by {{domxref("AbstractRange.startContainer", "startContainer")}} at which the first character of the range is located. +If the `startContainer` is a {{domxref("Node")}} of type {{domxref("Text")}}, {{domxref("Comment")}}, or {{domxref("CDATASection")}}, then the offset is the number of characters from the start of the `startContainer` to the boundary point of the range. For other {{domxref("Node")}} types, the `startOffset` is the number of child nodes between the start of the `startContainer` and the boundary point of the range. + ## Example ```js -let startOffset = range.startOffset; +const range = document.createRange(); +range.setStart(startNode, startOffset); +range.setEnd(endNode, endOffset); + +const startRangeOffset = range.startOffset; ``` ## Specifications diff --git a/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md b/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md index 71c8bbeb7d6e808..74c49a3cd4a6946 100644 --- a/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md +++ b/files/en-us/web/api/highlightregistry/highlightsfrompoint/index.md @@ -138,7 +138,7 @@ let highlightCount = 1; Next, we define a [`keydown`](/en-US/docs/Web/API/Element/keydown_event) event handler that applies a custom highlight to any selected text if h is pressed on the keyboard. Inside, we start by grabbing the selected text using {{domxref("Window.getSelection()")}} and converting it to a {{domxref("Range")}} using {{domxref("Selection.getRangeAt()")}}. -We check that the `selectedRange` object's [`startContainer`](/en-US/docs/Web/API/Range/startContainer) and [`endContainer`](/en-US/docs/Web/API/Range/endContainer) are both equal to the paragraph `textNode`, to make sure we don't allow any cross-container highlights. If so, we set the custom `highlightName` we want to apply to the `selectedRange` using `highlight${highlightCount++}`. Since we are incrementing `highlightCount`, we add in a check — when it reaches `4`, we set it back to `1`. This has the effect of cycling through the available highlights in order as they are set. +We check that the `selectedRange` object's [`startContainer`](/en-US/docs/Web/API/AbstractRange/startContainer) and [`endContainer`](/en-US/docs/Web/API/AbstractRange/endContainer) are both equal to the paragraph `textNode`, to make sure we don't allow any cross-container highlights. If so, we set the custom `highlightName` we want to apply to the `selectedRange` using `highlight${highlightCount++}`. Since we are incrementing `highlightCount`, we add in a check — when it reaches `4`, we set it back to `1`. This has the effect of cycling through the available highlights in order as they are set. Finally for the `keydown` event handler, we create a new `highlight` object using the {{domxref("Highlight.Highlight", "Highlight()")}} constructor, passing it the `selectedRange` we created earlier. We then apply the chosen custom highlight referenced in `highlightName` to `highlight` using the {{domxref("HighlightRegistry.set()")}} method. diff --git a/files/en-us/web/api/range/collapse/index.md b/files/en-us/web/api/range/collapse/index.md index 0823030e5709c25..d090e4f08a7a3f0 100644 --- a/files/en-us/web/api/range/collapse/index.md +++ b/files/en-us/web/api/range/collapse/index.md @@ -13,7 +13,7 @@ The **`collapse()`** method of the {{domxref("Range")}} interface collapses the A collapsed {{domxref("Range")}} is empty, containing no content, specifying a single-point in a DOM tree. To determine if a {{domxref("Range")}} is already collapsed, -see the {{domxref("Range.collapsed")}} property. +see the {{domxref("AbstractRange.collapsed")}} property. ## Syntax diff --git a/files/en-us/web/api/range/collapsed/index.md b/files/en-us/web/api/range/collapsed/index.md deleted file mode 100644 index 81c9553d6aa3c0a..000000000000000 --- a/files/en-us/web/api/range/collapsed/index.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: "Range: collapsed property" -short-title: collapsed -slug: Web/API/Range/collapsed -page-type: web-api-instance-property -browser-compat: api.Range.collapsed ---- - -{{ APIRef("DOM") }} - -The **`Range.collapsed`** read-only property returns a -boolean flag indicating whether the start and end points of the -{{domxref("Range")}} are at the same position. It returns `true` if the start -and end boundary points of the {{domxref("Range")}} are the same point in the DOM, -`false` if not. - -A collapsed {{domxref("Range")}} is empty (containing no content), and specifies a -single point in a DOM tree. To collapse a range, see the {{domxref("Range.collapse()")}} -method. - -## Value - -A boolean. - -## Examples - -```js -let range = document.createRange(); - -range.setStart(startNode, startOffset); -range.setEnd(endNode, endOffset); -isCollapsed = range.collapsed; -``` - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} - -## See also - -- [The DOM interfaces index](/en-US/docs/Web/API/Document_Object_Model) diff --git a/files/en-us/web/api/range/commonancestorcontainer/index.md b/files/en-us/web/api/range/commonancestorcontainer/index.md index c95b89ce02eac2d..0906d0162981a83 100644 --- a/files/en-us/web/api/range/commonancestorcontainer/index.md +++ b/files/en-us/web/api/range/commonancestorcontainer/index.md @@ -11,7 +11,7 @@ browser-compat: api.Range.commonAncestorContainer The **`Range.commonAncestorContainer`** read-only property returns the deepest — or furthest down the document tree — {{domxref("Node")}} that contains both [boundary points](https://dom.spec.whatwg.org/#introduction-to-dom-ranges) of the {{domxref("Range")}}. This means that if -{{domxref("Range.startContainer")}} and {{domxref("Range.endContainer")}} both refer to +{{domxref("AbstractRange.startContainer", "startContainer")}} and {{domxref("AbstractRange.endContainer", "endContainer")}} both refer to the same node, this node is the **common ancestor container**. Since a `Range` need not be continuous, and may also partially select nodes, diff --git a/files/en-us/web/api/range/endcontainer/index.md b/files/en-us/web/api/range/endcontainer/index.md deleted file mode 100644 index 0177dc2da311675..000000000000000 --- a/files/en-us/web/api/range/endcontainer/index.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "Range: endContainer property" -short-title: endContainer -slug: Web/API/Range/endContainer -page-type: web-api-instance-property -browser-compat: api.Range.endContainer ---- - -{{ApiRef("DOM")}} - -The **`Range.endContainer`** read-only property returns the -{{domxref("Node")}} within which the {{domxref("Range")}} ends. To change the end -position of a node, use the {{domxref("Range.setEnd()")}} method or a similar one. - -## Value - -A {{domxref("Node")}} object. - -## Examples - -```js -const range = document.createRange(); - -range.setStart(startNode, startOffset); -range.setEnd(endNode, endOffset); -endRangeNode = range.endContainer; -``` - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} - -## See also - -- [The DOM interfaces index](/en-US/docs/Web/API/Document_Object_Model) diff --git a/files/en-us/web/api/range/endoffset/index.md b/files/en-us/web/api/range/endoffset/index.md deleted file mode 100644 index edd85972ac8e917..000000000000000 --- a/files/en-us/web/api/range/endoffset/index.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "Range: endOffset property" -short-title: endOffset -slug: Web/API/Range/endOffset -page-type: web-api-instance-property -browser-compat: api.Range.endOffset ---- - -{{ApiRef("DOM")}} - -The **`Range.endOffset`** read-only property returns a number -representing where in the {{domxref("Range.endContainer")}} the {{domxref("Range")}} -ends. - -If the `endContainer` is a {{domxref("Node")}} of type {{domxref("Text")}}, -{{domxref("Comment")}}, or {{domxref("CDATASection")}}, then the offset is the number of -characters from the start of the `endContainer` to the boundary point of the -{{domxref("Range")}}. For other {{domxref("Node")}} types, the `endOffset` is -the number of child nodes between the start of the `endContainer` and the -boundary point of the {{domxref("Range")}}. This property is read-only. To change the -`endOffset` of a {{domxref("Range")}}, use one of the -{{domxref("Range.setEnd")}} methods. - -## Value - -A number. - -## Examples - -```js -const range = document.createRange(); - -range.setStart(startNode, startOffset); -range.setEnd(endNode, endOffset); -endRangeOffset = range.endOffset; -``` - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} - -## See also - -- [The DOM interfaces index](/en-US/docs/Web/API/Document_Object_Model) diff --git a/files/en-us/web/api/range/index.md b/files/en-us/web/api/range/index.md index 7f7fb41c872dbbb..48dadf8e046ae60 100644 --- a/files/en-us/web/api/range/index.md +++ b/files/en-us/web/api/range/index.md @@ -15,27 +15,17 @@ There also is the {{domxref("Range.Range()", "Range()")}} constructor available. {{InheritanceDiagram}} +## Constructor + +- {{ domxref("Range.Range()", "Range()") }} + - : Returns a `Range` object with the global {{domxref("Document")}} as its start and end. + ## Instance properties -_The properties below are inherited from its parent interface, {{domxref("AbstractRange")}}._ +_Also inherits properties from its parent interface, {{domxref("AbstractRange")}}._ -- {{domxref("Range.collapsed")}} {{ReadOnlyInline}} - - : Returns a boolean value indicating whether the range's start and end points are at the same position. - {{domxref("Range.commonAncestorContainer")}} {{ReadOnlyInline}} - : Returns the deepest {{ domxref("Node") }} that contains the `startContainer` and `endContainer` nodes. -- {{domxref("Range.endContainer")}} {{ReadOnlyInline}} - - : Returns the {{ domxref("Node") }} within which the `Range` ends. -- {{domxref("Range.endOffset")}} {{ReadOnlyInline}} - - : Returns a number representing where in the `endContainer` the `Range` ends. -- {{domxref("Range.startContainer")}} {{ReadOnlyInline}} - - : Returns the {{ domxref("Node") }} within which the `Range` starts. -- {{domxref("Range.startOffset")}} {{ReadOnlyInline}} - - : Returns a number representing where in the `startContainer` the `Range` starts. - -## Constructor - -- {{ domxref("Range.Range()", "Range()") }} - - : Returns a `Range` object with the global {{domxref("Document")}} as its start and end. ## Instance methods diff --git a/files/en-us/web/api/range/startcontainer/index.md b/files/en-us/web/api/range/startcontainer/index.md deleted file mode 100644 index 1b02ac73902aca7..000000000000000 --- a/files/en-us/web/api/range/startcontainer/index.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: "Range: startContainer property" -short-title: startContainer -slug: Web/API/Range/startContainer -page-type: web-api-instance-property -browser-compat: api.Range.startContainer ---- - -{{ApiRef("DOM")}} - -The **`Range.startContainer`** read-only property returns the -{{domxref("Node")}} within which the `Range` starts. To change the start -position of a node, use one of the {{domxref("Range.setStart()")}} methods. - -## Value - -A {{domxref("Node")}} object. - -## Examples - -```js -range = document.createRange(); -range.setStart(startNode, startOffset); -range.setEnd(endNode, endOffset); -startRangeNode = range.startContainer; -``` - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} - -## See also - -- [The DOM interfaces index](/en-US/docs/Web/API/Document_Object_Model) diff --git a/files/en-us/web/api/range/startoffset/index.md b/files/en-us/web/api/range/startoffset/index.md deleted file mode 100644 index 0ef5992ff8e9df0..000000000000000 --- a/files/en-us/web/api/range/startoffset/index.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: "Range: startOffset property" -short-title: startOffset -slug: Web/API/Range/startOffset -page-type: web-api-instance-property -browser-compat: api.Range.startOffset ---- - -{{ApiRef("DOM")}} - -The **`Range.startOffset`** read-only property returns a number -representing where in the `startContainer` the `Range` starts. - -If the `startContainer` is a {{domxref("Node")}} of type -{{domxref("Text")}}, {{domxref("Comment")}}, or {{domxref("CDATASection")}}, then the -offset is the number of characters from the start of the `startContainer` to -the boundary point of the {{domxref("Range")}}. For other {{domxref("Node")}} types, the -`startOffset` is the number of child nodes between the start of the -`startContainer` and the boundary point of the {{domxref("Range")}}. - -To change the `startOffset` of a {{domxref("Range")}}, use the -{{domxref("Range.setStart")}} method. - -## Value - -A number. - -## Examples - -```js -const range = document.createRange(); -range.setStart(startNode, startOffset); -range.setEnd(endNode, endOffset); -const startRangeOffset = range.startOffset; -``` - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} - -## See also - -- [The DOM interfaces index](/en-US/docs/Web/API/Document_Object_Model) diff --git a/files/en-us/web/api/staticrange/collapsed/index.md b/files/en-us/web/api/staticrange/collapsed/index.md deleted file mode 100644 index 065646515d98ec6..000000000000000 --- a/files/en-us/web/api/staticrange/collapsed/index.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: "StaticRange: collapsed property" -short-title: collapsed -slug: Web/API/StaticRange/collapsed -page-type: web-api-instance-property -browser-compat: api.StaticRange.collapsed ---- - -{{APIRef("DOM WHATWG")}} - -The **`collapsed`** read-only property -of the {{domxref("StaticRange")}} interface returns `true` if the range's -start position and end position are the same. - -## Value - -A boolean value which is `true` if the range -is **collapsed**. A collapsed range is one in which the start and end -positions are the same, resulting in a zero-character-long range. - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} diff --git a/files/en-us/web/api/staticrange/endcontainer/index.md b/files/en-us/web/api/staticrange/endcontainer/index.md deleted file mode 100644 index c20f617b388244e..000000000000000 --- a/files/en-us/web/api/staticrange/endcontainer/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: "StaticRange: endContainer property" -short-title: endContainer -slug: Web/API/StaticRange/endContainer -page-type: web-api-instance-property -browser-compat: api.StaticRange.endContainer ---- - -{{APIRef("DOM WHATWG")}} - -The **`endContainer`** property of the {{domxref("StaticRange")}} interface returns the end {{domxref("Node")}} for the range. - -## Value - -The DOM {{domxref("Node")}} which contains the final character of the range. - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} diff --git a/files/en-us/web/api/staticrange/endoffset/index.md b/files/en-us/web/api/staticrange/endoffset/index.md deleted file mode 100644 index dbc40c416933490..000000000000000 --- a/files/en-us/web/api/staticrange/endoffset/index.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "StaticRange: endOffset property" -short-title: endOffset -slug: Web/API/StaticRange/endOffset -page-type: web-api-instance-property -browser-compat: api.StaticRange.endOffset ---- - -{{APIRef("DOM")}} - -The **`endOffset`** property of the {{domxref("StaticRange")}} -interface returns the offset into the end node of the range's end position. - -## Value - -An integer value indicating the number of characters into the {{domxref("Node")}} -indicated by {{domxref("StaticRange.endContainer", "endContainer")}} at which the final -character of the range is located. - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} diff --git a/files/en-us/web/api/staticrange/index.md b/files/en-us/web/api/staticrange/index.md index 04e07c4a6f5092c..4ddcca2efbe1fac 100644 --- a/files/en-us/web/api/staticrange/index.md +++ b/files/en-us/web/api/staticrange/index.md @@ -22,18 +22,7 @@ This interface offers the same set of properties and methods as `AbstractRange`. ## Instance properties -_The properties below are inherited from its parent interface, {{domxref("AbstractRange")}}._ - -- {{domxref("StaticRange.collapsed")}} {{ReadOnlyInline}} - - : Returns a Boolean value that is `true` if the range's start and end positions are the same, resulting in a range of length 0. -- {{domxref("StaticRange.endContainer")}} {{ReadOnlyInline}} - - : Returns the DOM {{domxref("Node")}} which contains the ending point of the range. The offset into the node at which the end position is located is indicated by `endOffset`. -- {{domxref("StaticRange.endOffset")}} {{ReadOnlyInline}} - - : Returns an integer value indicating the offset into the node given by `endContainer` at which the last character of the range is found. -- {{domxref("StaticRange.startContainer")}} {{ReadOnlyInline}} - - : Returns the DOM {{domxref("Node")}} which contains the starting point of the range (which is in turn identified by `startOffset`. -- {{domxref("StaticRange.startOffset")}} {{ReadOnlyInline}} - - : Returns an integer value indicating the offset into the node specified by `startContainer` at which the first character of the range is located. +_Inherits properties from its parent interface, {{domxref("AbstractRange")}}._ ## Usage notes diff --git a/files/en-us/web/api/staticrange/startcontainer/index.md b/files/en-us/web/api/staticrange/startcontainer/index.md deleted file mode 100644 index bb1329cdae3ca2f..000000000000000 --- a/files/en-us/web/api/staticrange/startcontainer/index.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: "StaticRange: startContainer property" -short-title: startContainer -slug: Web/API/StaticRange/startContainer -page-type: web-api-instance-property -browser-compat: api.StaticRange.startContainer ---- - -{{APIRef("DOM")}} - -The read-only **`startContainer`** -property of the {{domxref("StaticRange")}} interface returns the start -{{domxref("Node")}} for the range. - -## Value - -The DOM {{domxref("Node")}} inside which the start position of the range is found. - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} diff --git a/files/en-us/web/api/staticrange/startoffset/index.md b/files/en-us/web/api/staticrange/startoffset/index.md deleted file mode 100644 index 7aac0badd062341..000000000000000 --- a/files/en-us/web/api/staticrange/startoffset/index.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: "StaticRange: startOffset property" -short-title: startOffset -slug: Web/API/StaticRange/startOffset -page-type: web-api-instance-property -browser-compat: api.StaticRange.startOffset ---- - -{{APIRef("DOM")}} - -The read-only **`startOffset`** -property of the {{domxref("StaticRange")}} interface returns the offset into the start -node of the range's start position. - -## Value - -An integer value indicating the number of characters into the {{domxref("Node")}} -indicated by {{domxref("StaticRange.startContainer", "startContainer")}} at which the -first character of the range is located. - -## Specifications - -{{Specifications}} - -## Browser compatibility - -{{Compat}} diff --git a/files/en-us/web/css/reference/at-rules/@custom-media/index.md b/files/en-us/web/css/reference/at-rules/@custom-media/index.md index 6ddfc5020d2c1f0..05743d37359c0db 100644 --- a/files/en-us/web/css/reference/at-rules/@custom-media/index.md +++ b/files/en-us/web/css/reference/at-rules/@custom-media/index.md @@ -5,9 +5,10 @@ page-type: css-at-rule status: - experimental browser-compat: css.at-rules.custom-media +sidebar: cssref --- -{{CSSRef}}{{SeeCompatTable}} +{{SeeCompatTable}} The **`@custom-media`** CSS [at-rule](/en-US/docs/Web/CSS/Reference/At-rules) defines aliases for long or complex [media queries](/en-US/docs/Web/CSS/Guides/Media_queries). Instead of repeating the same hardcoded `` in multiple {{cssxref("@media")}} at-rules, it can be defined once in a `@custom-media` at-rule and referenced throughout the stylesheet whenever needed. diff --git a/files/en-us/web/css/reference/properties/interactivity/index.md b/files/en-us/web/css/reference/properties/interactivity/index.md index 0a76e7a4dbe524d..b143ae30a564274 100644 --- a/files/en-us/web/css/reference/properties/interactivity/index.md +++ b/files/en-us/web/css/reference/properties/interactivity/index.md @@ -5,9 +5,10 @@ page-type: css-property status: - experimental browser-compat: css.properties.interactivity +sidebar: cssref --- -{{CSSRef}}{{seecompattable}} +{{seecompattable}} The **`interactivity`** [CSS](/en-US/docs/Web/CSS) property specifies whether an element and its descendant nodes are set to be [inert](/en-US/docs/Web/HTML/Reference/Global_attributes/inert). diff --git a/files/en-us/web/css/reference/properties/object-view-box/index.md b/files/en-us/web/css/reference/properties/object-view-box/index.md index cc7400c70ca3f2d..933053360734525 100644 --- a/files/en-us/web/css/reference/properties/object-view-box/index.md +++ b/files/en-us/web/css/reference/properties/object-view-box/index.md @@ -5,9 +5,10 @@ page-type: css-property status: - experimental browser-compat: css.properties.object-view-box +sidebar: cssref --- -{{CSSRef}}{{SeeCompatTable}} +{{SeeCompatTable}} The **`object-view-box`** [CSS](/en-US/docs/Web/CSS) property defines a rectangle as a viewable area (viewbox) within a {{glossary("replaced elements", "replaced element")}}, enabling the content of the replaced element to be zoomed or panned. It works similarly to the SVG {{SVGAttr("viewBox")}} attribute. diff --git a/files/en-us/web/css/reference/values/progress/index.md b/files/en-us/web/css/reference/values/progress/index.md index f3d571f55c4be19..459b038d649ba61 100644 --- a/files/en-us/web/css/reference/values/progress/index.md +++ b/files/en-us/web/css/reference/values/progress/index.md @@ -3,10 +3,9 @@ title: progress() slug: Web/CSS/Reference/Values/progress page-type: css-function browser-compat: css.types.progress +sidebar: cssref --- -{{CSSRef}} - The **`progress()`** [CSS](/en-US/docs/Web/CSS) [function](/en-US/docs/Web/CSS/Reference/Values/Functions) returns a {{cssxref("<number>")}} value representing the position of one value (the progress value) relative to two other values (the progress start and end values). ## Syntax