Коротко

Метод возвращает объектSelection, представленный в виде диапазона текста, который пользователь выделил на странице.

Синтаксис

selection = window.getSelection();

Значение

ОбъектSelection.

При добавлении в параметр пустую строку или воспользовавшись методомSelection.toString() вам вернут строку, которую выделил пользователь.

Пример

function foo() {  var selObj = window.getSelection();  alert(selObj);  var selRange = selObj.getRangeAt(0);  // вернёт диапазон Range}

Примечания

String representation of the Selection object

В JavaScript при попытке передать в функцию, принимающую строку (как на примерwindow.alert() или жеdocument.write()), функция попробует сделать из любого параметра строку, даже если этот параметр является объектом, функцией со своими методами и свойствами.

В приведённом выше примереselObj.toString() автоматически задействуется, когда мы передаём вwindow.alert() переменную selObj как параметр, который должен быть строкой. Однако мы не можем использовать свойства и метода объекта String, как на пример :length,substr. В следствии чего, вам необходимо будет применить вручную методtoString(), как тут:

var selectedText = selObj.toString();

• selObj это объектSelection.
• selectedText это строка (Выделенный текст).

Родственные объекты

Вы так же можете использовать такой способ вызоваDocument.getSelection(), который работает идентичноWindow.getSelection().

Поля ввода HTML (inputs) предоставляют более удобный API для работы с выделенным текстом (смотритеHTMLInputElement.setSelectionRange()).

На заметку, разница междуselection иfocus.Document.activeElement - это то, что вернётся элемент, который выделен (focused) .

Спецификации

Совместимость с браузерами

Смотрите также

• Selection API
• Selection
• Range
• Document.getSelection()
• HTMLInputElement.setSelectionRange()