Spec-Zone.ru › Web APIs

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

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

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

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

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

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

Синтаксис

setPosition(node)
setPosition(node, offset)

Параметры

node

Позиция курсора будет внутри этого узла. Это значение также может быть установлено в null — если null указано, метод будет вести себя как Selection.removeAllRanges(), т.е. все диапазоны будут удалены из выделения.

offset Необязательно

Смещение в node, до которого будет свернут выбор. Если не указано, используется значение по умолчанию 0.

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

Ничего (undefined).

Примеры

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

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
setPosition 1 14 55 15 1.3 18 55 14 1 1.0 4.4

См. также

  • Selection.collapse()

© 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/setPosition

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API