Выбор: метод collapse()

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

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

Метод Selection.collapse() сворачивает текущий выбор до одной точки. Документ не изменяется. Если содержимое сфокусировано и редактируемо, курсор будет мигать там.

Примечание: Этот метод является псевдонимом для метода Selection.setPosition().

Синтаксис

collapse(node)
collapse(node, offset)

Параметры

node: Позиция курсора будет находиться в этом узле. Это значение также может быть установлено в null — если null указано, метод будет вести себя как Selection.removeAllRanges(), т.е. все диапазоны будут удалены из выбора.
offset Необязательно: Смещение в node, до которого будет сведен выбор. Если не указано, используется значение по умолчанию 0.

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

None (undefined).

Примеры

// Place the caret at the beginning of an HTML document's body.
const body = document.querySelector("body");
window.getSelection().collapse(body, 0);

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

Спецификация
Selection API # dom-selection-collapse

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`collapse`	1	12	1	≤12.1	1.3	18	4	≤12.1	1	1.0	4.4
`accepts_nodes_in_shadow_trees`	Нет	Нет	предварительный просмотр	Нет	Нет	Нет	Нет	Нет	Нет	Нет	Нет
`node_parameter_nullable`	39	≤79	55	26	1.3	39	55	26	1	4.0	39
`offset_parameter_optional`	1	≤79	55	≤15	1.3	18	55	≤14	1	1.0	4.4

См. также

Selection.setPosition()

© 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/Selection/collapse