StaticRange
Базовая реализация Широко доступна
Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.
Интерфейс DOM StaticRange расширяет AbstractRange, предоставляя метод для указания диапазона содержимого в DOM, чьё содержимое не обновляется для отражения изменений, происходящих в дереве DOM.
Этот интерфейс предлагает тот же набор свойств и методов, что и AbstractRange.
AbstractRange и StaticRange недоступны из потоков веб-работы.
Конструктор
StaticRange()-
Создаёт новый объект
StaticRangeс использованием параметров, задающих значения по умолчанию для его свойств.
Свойства экземпляра
Нижеперечисленные свойства унаследованы от родительского интерфейса AbstractRange.
-
StaticRange.collapsedТолько для чтения -
Возвращает булево значение, которое
true, если начальная и конечная позиции диапазона совпадают, что соответствует диапазону длиной 0. -
StaticRange.endContainerТолько для чтения -
Возвращает узел DOM
Node, содержащий конечную точку диапазона. Смещение внутри узла, в котором находится конечная позиция, указано значениемendOffset. -
StaticRange.endOffsetТолько для чтения -
Возвращает целое число, указывающее смещение внутри узла, указанного значением
endContainer, в котором находится последний символ диапазона. -
StaticRange.startContainerТолько для чтения -
Возвращает узел DOM
Node, содержащий начальную точку диапазона (который, в свою очередь, идентифицируется значениемstartOffset). -
StaticRange.startOffsetТолько для чтения -
Возвращает целое число, указывающее смещение внутри узла, указанного значением
startContainer, в котором находится первый символ диапазона.
Примечания по использованию
Диапазон DOM определяет отрезок содержимого в документе, потенциально начинающийся внутри одного узла (или элемента) и заканчивающийся внутри другого. В отличие от Range, StaticRange представляет собой диапазон, фиксированный во времени; он не изменяется, чтобы сохранять то же содержимое внутри, когда документ меняется. Если в DOM вносятся какие-либо изменения, фактические данные, содержащиеся в диапазоне, указанном StaticRange , могут измениться. Это позволяет пользовательскому агенту узла избежать многих ненужных вычислений, если веб-приложению или сайту не нужен постоянно обновляемый диапазон.
Спецификации
| Спецификация |
|---|
| DOM # interface-staticrange |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
StaticRange |
90 | 90 | 71 | 76 | 13.1 | 90 | 79 | 64 | 13.4 | 15.0 | 90 |
StaticRange |
60 | 18 | 69В Firefox,StaticRange в настоящее время может использоваться только кодом браузера или кодом с расширенными разрешениями; он ещё не доступен для веб-приложений. |
47 | 10.1 | 60 | 79 | 44 | 10.3 | 8.0 | 60 |
collapsed |
60 | 18 | 69 | 47 | 10.1 | 60 | 79 | 44 | 10.3 | 8.0 | 60 |
endContainer |
60 | 18 | 69 | 47 | 10.1 | 60 | 79 | 44 | 10.3 | 8.0 | 60 |
endOffset |
60 | 18 | 69 | 47 | 10.1 | 60 | 79 | 44 | 10.3 | 8.0 | 60 |
startContainer |
60 | 18 | 69 | 47 | 10.1 | 60 | 79 | 44 | 10.3 | 8.0 | 60 |
startOffset |
60 | 18 | 69 | 47 | 10.1 | 60 | 79 | 44 | 10.3 | 8.0 | 60 |
См. также
- Динамический обновляемый диапазон содержимого в DOM:
Range -
AbstractRange, абстрактный интерфейс, от которого происходят все диапазоны
© 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/StaticRange