Selection.getRangeAt()
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.
The Selection.getRangeAt()
method returns a range object representing one of the ranges currently selected.
Syntax
JavaScript
Copy Code
range = sel.getRangeAt(index)
Parameters
range
- The
Range
object that will be returned. index
- The zero-based index of the range to return. A negative number or a number greater than or equal to
Selection.rangeCount
will result in an error.
Examples
JavaScript
Copy Code
var ranges = []; sel = window.getSelection(); for(var i = 0; i < sel.rangeCount; i++) { ranges[i] = sel.getRangeAt(i); } /* Each item in the ranges array is now * a range object representing one of the * ranges in the current selection */
Specifications
Specification | Status | Comment |
---|---|---|
HTML Editing APIs The definition of 'Selection.getRangeAt()' in that specification. |
Editor's Draft | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | Yes | (Yes) | ? | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | (Yes) | 1.0 | ? | ? | ? |
See also
Selection
, the interface it belongs to.- Tree Selection (for the
getRangeAt()
method on thensITreeSelection
interface)
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/selection/getrangeat