ol/layer/Base~BaseLayer
import BaseLayer from 'ol/layer/Base.js';
Абстрактный базовый класс; обычно используется только для создания подклассов и не создаётся в приложениях. Обратите внимание: для BaseLayer и всех его подклассов любое свойство, заданное в параметрах, устанавливается как свойство BaseObject объекта слоя, поэтому за ним можно наблюдать, и для него доступны методы чтения и записи.
-
new BaseLayer(options)
-
Имя Тип Описание classNamestring (по умолчанию 'ol-layer') Имя класса CSS, задаваемое элементу слоя.
opacitynumber (по умолчанию 1) Непрозрачность (0, 1).
visibleboolean (по умолчанию true) Видимость.
extentExtent | undefined Ограничивающая область для отображения слоя. За пределами этой области слой отображаться не будет.
zIndexnumber | undefined Z-индекс для отображения слоя. Во время отображения слои упорядочиваются сначала по Z-индексу, а затем по положению. Если задано
undefined, для слоёв, добавленных в коллекциюlayersкарты, предполагается значениеzIndex, равное 0, а такжеInfinity, если был использован методsetMap()слоя.minResolutionnumber | undefined Минимальное разрешение (включительно), при котором этот слой будет виден.
maxResolutionnumber | undefined Максимальное разрешение (исключительно), ниже которого этот слой будет виден.
minZoomnumber | undefined Минимальный уровень масштабирования вида (исключительно), выше которого этот слой будет виден.
maxZoomnumber | undefined Максимальный уровень масштабирования вида (включительно), при котором этот слой будет виден.
backgroundBackgroundColor | undefined Цвет фона слоя. Если он не задан, фон отображаться не будет.
propertiesProperties | undefined Произвольные наблюдаемые свойства. Доступ к ним можно получить с помощью
#get()и#set().События:
-
change(BaseEvent) — общее событие изменения. Вызывается при увеличении счётчика ревизии. -
change:extent(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) — вызывается при изменении свойства.
-
Подклассы
Расширяет
Наблюдаемые свойства
| Имя | Тип | Можно задать | тип ObjectEvent | Описание |
|---|---|---|---|---|
extent | Extent | undefined | да | change:extent | Область слоя. |
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} унаследовано
-
Отправляет событие и вызывает все обработчики, ожидающие события этого типа. Параметр event может быть строкой или объектом со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-либо вызвал preventDefault для объекта события или если какой-либо обработчик вернул false.
-
get(key){*} унаследовано
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getExtent(){Extent | undefined}
-
Возвращает
extentслоя илиundefined, если слой будет виден независимо от экстента.Возвращает:
Экстент слоя.
-
getKeys(){Array.<string>} унаследовано
-
Возвращает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
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 Экстент слоя.
-
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_Base-BaseLayer.html