Документ: метод getSelection()

Базовая поддержка Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.

Метод getSelection() интерфейса Document возвращает объект Selection, связанный с этим документом, представляющий выделенный пользователем диапазон текста или текущую позицию курсора.

Синтаксис

getSelection()

Параметры

Нет.

Возвращаемое значение

Объект Selection или null, если документ не имеет контекста просмотра (например, это документ <iframe>, который не прикреплён к документу).

Примеры

Получение объекта Selection

const selection = document.getSelection();
const selRange = selection.getRangeAt(0);
// do stuff with the range

console.log(selection); // Selection object

Строковое представление объекта Selection

Некоторые функции (например, Window.alert()) автоматически вызывают toString(), и возвращаемое значение передаётся в функцию. Вследствие этого, будет возвращён выделенный текст, а не объект Selection.

alert(selection);

Однако не все функции автоматически вызывают toString(). Чтобы использовать объект Selection как строку, вызовите его метод toString() напрямую:

let selectedText = selection.toString();

Связанные объекты

Вы можете вызвать Window.getSelection(), который идентичен window.document.getSelection().

Стоит отметить, что в настоящее время getSelection() не работает с содержимым элементов <input> в Firefox. Вместо этого можно использовать HTMLInputElement.setSelectionRange() для решения этой проблемы.

Обратите внимание на разницу между выделением и фокусом. Document.activeElement возвращает элемент, имеющий фокус.

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

Спецификация
API выбора # dom-document-getselection

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari в iOS	Samsung Internet	WebView Android
`getSelection`	2	12	57 1–57 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	≤12.1	4	18	57 4–57 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	≤12.1	3.2	1.0	≤37

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/getSelection