ol/layer/Group~LayerGroup
import LayerGroup from 'ol/layer/Group.js';
Collection слоёв, обрабатываемых вместе.
При изменении группы/Collection генерируется общее событие change.
-
new LayerGroup(options)
-
Имя Тип Описание opacitynumber (по умолчанию 1) Непрозрачность (0, 1).
visibleboolean (по умолчанию true) Видимость.
extentExtent | undefined Ограничивающая область для отображения слоя. За пределами этой области слой отображаться не будет.
zIndexnumber | undefined Z-индекс для отображения слоя. При отображении слои упорядочиваются сначала по Z-индексу, а затем по позиции. Если задано
undefined, для слоёв, добавленных в коллекциюlayersкарты, предполагается значениеzIndex, а для слоёв, для которых использовался методsetMap(), —Infinity.minResolutionnumber | undefined Минимальное разрешение (включительно), при котором этот слой будет видимым.
maxResolutionnumber | undefined Максимальное разрешение (не включительно), ниже которого этот слой будет видимым.
minZoomnumber | undefined Минимальный уровень масштабирования вида (не включительно), выше которого этот слой будет видимым.
maxZoomnumber | undefined Максимальный уровень масштабирования вида (включительно), при котором этот слой будет видимым.
layersArray<BaseLayer> | Collection<BaseLayer> | undefined Дочерние слои.
propertiesObject.<string, *> | undefined Произвольные наблюдаемые свойства. Доступ к ним можно получить с помощью
#get()и#set().Генерируемые события:
-
addlayer(GroupEvent) — генерируется при добавлении слоя -
change(BaseEvent) — общее событие изменения. Генерируется при увеличении счётчика ревизий. -
change:extent(ObjectEvent) -
change:layers(ObjectEvent) -
change:maxResolution(ObjectEvent) -
change:maxZoom(ObjectEvent) -
change:minResolution(ObjectEvent) -
change:minZoom(ObjectEvent) -
change:opacity(ObjectEvent) -
change:visible(ObjectEvent) -
change:zIndex(ObjectEvent) -
error(BaseEvent) — общее событие ошибки. Генерируется при возникновении ошибки. -
propertychange(ObjectEvent) — генерируется при изменении свойства. -
removelayer(GroupEvent) — генерируется при удалении слоя
-
Наследует
Наблюдаемые свойства
| Имя | Тип | Можно задать | Тип ObjectEvent | Описание |
|---|---|---|---|---|
extent | Extent | undefined | да | change:extent | Область слоя. |
layers | Collection<BaseLayer> | да | change:layers | Коллекция |
maxResolution | number | да | change:maxresolution | Максимальное разрешение слоя. |
maxZoom | number | да | change:maxzoom | Максимальный уровень масштабирования слоя. |
minResolution | number | да | change:minresolution | Минимальное разрешение слоя. |
minZoom | number | да | change:minzoom | Минимальный уровень масштабирования слоя. |
opacity | number | да | change:opacity | Непрозрачность слоя. |
visible | boolean | да | change:visible | Значение свойства |
zIndex | number | undefined | да | change:zindex | Z-индекс слоя. |
Методы
-
changed() унаследовано
-
Увеличивает счётчик ревизий и отправляет событие 'change'.
-
dispatchEvent(event){boolean | undefined} унаследовано
-
Отправляет событие и вызывает все обработчики, ожидающие события этого типа. Параметр события может быть строкой или объектом со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-либо вызвал preventDefault для объекта события или если любой из обработчиков вернул false.
-
get(key){*} унаследовано
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getExtent(){Extent | undefined} унаследовано
-
Возвращает
extentслоя илиundefined, если слой будет виден независимо от экстента.Возвращает:
Экстент слоя.
-
getKeys(){Array.<string>} унаследовано
-
Возвращает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getLayers(){Collection<BaseLayer>}
-
Возвращает
collectionlayersэтой группы.Возвращает:
Коллекцияlayers, входящих в эту группу.
-
getMaxResolution(){number} унаследовано
-
Возвращает максимальное разрешение слоя. Если для слоя не задано максимальное разрешение, возвращает Infinity.
Возвращает:
Максимальное разрешение слоя.
-
getMaxZoom(){number} унаследовано
-
Возвращает максимальный уровень масштабирования слоя. Если для слоя не задан максимальный уровень масштабирования, возвращает Infinity.
Возвращает:
Максимальный уровень масштабирования слоя.
-
getMinResolution(){number} унаследовано
-
Возвращает минимальное разрешение слоя. Если для слоя не задано минимальное разрешение, возвращает 0.
Возвращает:
Минимальное разрешение слоя.
-
getMinZoom(){number} унаследовано
-
Возвращает минимальный уровень масштабирования слоя. Если для слоя не задан минимальный уровень масштабирования, возвращает -Infinity.
Возвращает:
Минимальный уровень масштабирования слоя.
-
getOpacity(){number} унаследовано
-
Возвращает непрозрачность слоя (от 0 до 1).
Возвращает:
Непрозрачность слоя.
-
getProperties(){NoInfer.<Properties>} унаследовано
-
Возвращает объект со всеми именами свойств и их значениями.
Возвращает:
Объект.
-
getRevision(){number} унаследовано
-
Возвращает номер версии этого объекта. При каждом изменении объекта номер его версии увеличивается.
Возвращает:
Номер ревизии.
-
getVisible(){boolean} унаследовано
-
Возвращает значение свойства
visibleэтого слоя. Чтобы узнать, виден ли слой на карте, используйте вместо этогоisVisible().Возвращает:
Значение свойстваvisibleслоя.
-
getZIndex(){number | undefined} унаследовано
-
Возвращает Z-индекс слоя, используемый для упорядочивания слоёв перед отрисовкой. Если слой не управляется, возвращает undefined.
Возвращает:
Z-индекс слоя.
-
on(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Ожидает событие указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
once(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Однократно ожидает событие указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
set(key, value, silent) унаследовано
-
Задаёт значение.
Имя Тип Описание keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновить без отправки события.
-
setExtent(extent) унаследовано
-
Задаёт экстент, в пределах которого слой виден. Если
undefined, слой будет виден при любом экстенте.Имя Тип Описание extentExtent | undefined Экстент слоя.
-
setLayers(layers)
-
Задаёт
collectionlayersэтой группы.Имя Тип Описание layersCollection<BaseLayer> Коллекция
layers, входящих в эту группу. -
setMaxResolution(maxResolution) унаследовано
-
Задаёт максимальное разрешение, при котором слой виден.
Имя Тип Описание maxResolutionnumber Максимальное разрешение слоя.
-
setMaxZoom(maxZoom) унаследовано
-
Задаёт максимальный (не включая его) уровень масштабирования, при котором слой виден. Обратите внимание: уровни масштабирования для видимости слоя зависят от уровня масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.
Имя Тип Описание maxZoomnumber Максимальный уровень масштабирования слоя.
-
setMinResolution(minResolution) унаследовано
-
Задаёт минимальное разрешение, при котором слой виден.
Имя Тип Описание minResolutionnumber Минимальное разрешение слоя.
-
setMinZoom(minZoom) унаследовано
-
Задаёт минимальный (включая его) уровень масштабирования, при котором слой виден. Обратите внимание: уровни масштабирования для видимости слоя зависят от уровня масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.
Имя Тип Описание minZoomnumber Минимальный уровень масштабирования слоя.
-
setOpacity(opacity) унаследовано
-
Задаёт непрозрачность слоя; допустимые значения — от 0 до 1.
Имя Тип Описание opacitynumber Непрозрачность слоя.
-
setProperties(values, silent) унаследовано
-
Задаёт набор пар «ключ — значение». Обратите внимание: при этом изменяются существующие свойства и добавляются новые (существующие свойства не удаляются).
Имя Тип Описание valuesPartial.<NoInfer.<Properties>> Значения.
silentboolean | undefined Обновить без отправки события.
-
setVisible(visible) унаследовано
-
Задаёт видимость слоя (
trueилиfalse).Имя Тип Описание visibleboolean Видимость слоя.
-
setZIndex(zindex) унаследовано
-
Задаёт Z-индекс слоя, используемый для упорядочивания слоёв перед отрисовкой. По умолчанию Z-индекс равен 0.
Имя Тип Описание zindexnumber Z-индекс слоя.
-
un(type, listener) унаследовано
-
Прекращает ожидание события указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
-
unset(key, silent) унаследовано
-
Удаляет свойство.
Имя Тип Описание keystring Имя ключа.
silentboolean | undefined Удалить без отправки события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_layer_Group-LayerGroup.html