DOMSelection Interface / dart:html Library / Dart API Reference

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 object
range 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.

from MDN

Methods

Code void addRange(Range range) #

void addRange(Range range);

Code void collapse(Node node, int index) #

void collapse(Node node, int index);

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 extend(Node node, int offset) #

void extend(Node node, int offset);

Code Range getRangeAt(int index) #

Range getRangeAt(int index);

Code void modify(String alter, String direction, String granularity) #

void modify(String alter, String direction, String granularity);

Code void removeAllRanges() #

void removeAllRanges();

Code void selectAllChildren(Node node) #

void selectAllChildren(Node node);

Code void setBaseAndExtent(Node baseNode, int baseOffset, Node extentNode, int extentOffset) #

void setBaseAndExtent(Node baseNode, int baseOffset, Node extentNode, int extentOffset);

Code void setPosition(Node node, int offset) #

void setPosition(Node node, int offset);

Code String toString() #

String toString();

Fields

Code final Node anchorNode #

final Node anchorNode;

Code final int anchorOffset #

final int anchorOffset;

Code final Node baseNode #

final Node baseNode;

Code final int baseOffset #

final int baseOffset;

Code final Node extentNode #

final Node extentNode;

Code final int extentOffset #

final int extentOffset;

Code final Node focusNode #

final Node focusNode;

Code final int focusOffset #

final int focusOffset;

Code final bool isCollapsed #

final bool isCollapsed;

Code final int rangeCount #

final int rangeCount;

Code final String type #

final String type;

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.