DOMSelection Interface
Selection is the class of the object returned by window.getSelection()
and other methods. It represents the text selection in the greater page, possibly spanning multiple elements, when the user drags over static text and other parts of the page. For information about text selection in an individual text editing element, see Input
, TextArea
and document.activeElement
which typically return the parent object returned from window.getSelection()
.
A selection object represents the ranges
that the user has selected. Typically, it holds only one range, accessed as follows:
var selObj = window.getSelection(); var range = selObj.getRangeAt(0);
selObj
is a Selection objectrange
is a Range object
Calling the Selection/toString()
method returns the text contained in the selection, e.g
var selObj = window.getSelection(); window.alert(selObj);
Note that using a selection object as the argument to window.alert
will call the object's toString
method.
Methods
Code void collapseToEnd() #
void collapseToEnd();
Code void collapseToStart() #
void collapseToStart();
Code bool containsNode(Node node, bool allowPartial) #
bool containsNode(Node node, bool allowPartial);
Code void deleteFromDocument() #
void deleteFromDocument();
Code void empty() #
void empty();
Code void modify(String alter, String direction, String granularity) #
void modify(String alter, String direction, String granularity);
Code void removeAllRanges() #
void removeAllRanges();
Code void setBaseAndExtent(Node baseNode, int baseOffset, Node extentNode, int extentOffset) #
void setBaseAndExtent(Node baseNode, int baseOffset, Node extentNode, int extentOffset);
Fields
This page includes content from the Mozilla Foundation that is graciously licensed under a Creative Commons: Attribution-Sharealike license. Mozilla has no other association with Dart or dartlang.org. We encourage you to improve the web by contributing to The Mozilla Developer Network.