Диапазон: метод setEnd()

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

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

Метод Range.setEnd() устанавливает конечную позицию Range, которая должна находиться на заданном смещении в указанном узле x. Установка конечной точки выше (выше в документе), чем начальная точка, приведет к коллапсированному диапазону, при этом начальная и конечная точки будут установлены в указанной конечной позиции.

Синтаксис

setEnd(endNode, endOffset)

Параметры

endNode: Node, в пределах которого должен заканчиваться Range.
endOffset: Целое число, большее или равное нулю, представляющее смещение для конца Range от начала endNode.

Значение возврата

None (undefined).

Исключения

InvalidNodeTypeError DOMException: Узел, указанный endNode, является узлом типа DTD; конечные точки диапазона не могут быть расположены внутри узла типа DTD.
IndexSizeError DOMException: Значение, указанное endOffset, больше или равно длине узла или меньше нуля.

Примечания по использованию

Если endNode является Node типа Text, Comment или CDataSection, то endOffset представляет собой количество символов с начала endNode. Для других типов Node, endOffset представляет собой количество дочерних узлов между началом endNode.

Примеры

const range = document.createRange();
const endNode = document.getElementsByTagName("p").item(3);
const endOffset = endNode.childNodes.length;
range.setEnd(endNode, endOffset);

Примечание: setEnd() обычно используется в сочетании с setStart() для полной настройки диапазона.

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

Спецификация
DOM # dom-range-setend

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`setEnd`	1	12	1	9	1	18	4	10.1	1	1.0	4.4

См. также

Индекс интерфейсов DOM

© 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/Range/setEnd