Диапазон: метод surroundContents()
Базовая линия Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с марта 2017 года.
Метод Range.surroundContents() перемещает содержимое Range в новый узел, помещая новый узел в начало указанного диапазона.
Этот метод почти эквивалентен newNode.appendChild(range.extractContents()); range.insertNode(newNode). После окружения граничные точки range включают newNode.
Однако, будет выброшено исключение, если Range разделит узел, который не является Text, только одной из своих граничных точек. То есть, в отличие от альтернативного метода, если выбраны части узлов, они не будут клонированы, а операция завершится неудачно.
Синтаксис
surroundContents(newParent)
Параметры
Возвращаемое значение
Ничего (undefined).
Примеры
HTML
<span class="header-text">Put this in a headline</span>
JavaScript
const range = document.createRange();
const newParent = document.createElement("h1");
range.selectNode(document.querySelector(".header-text"));
range.surroundContents(newParent);
Результат
Спецификации
| Спецификация |
|---|
| DOM # dom-range-surroundcontents |
Совместимость браузеров
| Десктоп | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
surroundContents |
1 | 12 | 1 | 9 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 |
См. также
© 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/surroundContents
