ol/layer/Base~BaseLayer
import BaseLayer from 'ol/layer/Base.js';
Абстрактный базовый класс; обычно используется только для создания подклассов, а не для создания экземпляров в приложениях. Обратите внимание, что с BaseLayer и всеми его подклассами, любое свойство, заданное в параметрах, устанавливается как свойство BaseObject объекта слоя, поэтому оно наблюдаемо и имеет методы доступа get/set.
-
new BaseLayer(options)
-
Имя Тип Описание classNameстрока (по умолчанию 'ol-layer') Имя класса CSS, которое необходимо установить для элемента слоя.
opacityчисло (по умолчанию 1) Непрозрачность (0, 1).
visibleлогическое значение (по умолчанию true) Видимость.
extentExtent | undefined Граничный прямоугольник для отрисовки слоя. Слой не будет отрисовываться за пределами этого прямоугольника.
zIndexчисло | undefined Индекс Z для отрисовки слоя. При отрисовке слои упорядочиваются сначала по индексу Z, а затем по позиции. Если
undefined, для слоев, добавленных в коллекциюlayersкарты, предполагается значениеzIndex0, илиInfinity, если для слоя использовался методsetMap().minResolutionчисло | undefined Минимальное разрешение (включительно), при котором этот слой будет виден.
maxResolutionчисло | undefined Максимальное разрешение (исключительно) ниже которого этот слой будет виден.
minZoomчисло | undefined Минимальный уровень масштаба отображения (исключительно) выше которого этот слой будет виден.
maxZoomчисло | undefined Максимальный уровень масштаба отображения (включительно), при котором этот слой будет виден.
backgroundBackgroundColor | undefined Цвет фона для слоя. Если не указан, фон не будет отрисован.
propertiesОбъект.<строка, *> | 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) — Срабатывает при изменении свойства.
-
Подклассы
Расширяет
Наблюдаемые свойства
| Имя | Тип | Устанавливаемое | Тип события | Описание |
|---|---|---|---|---|
extent | Extent | undefined | да | change:extent | Прямоугольник слоя. |
maxResolution | число | да | change:maxresolution | Максимальное разрешение слоя. |
maxZoom | число | да | change:maxzoom | Максимальный уровень масштаба слоя. |
minResolution | число | да | change:minresolution | Минимальное разрешение слоя. |
minZoom | число | да | change:minzoom | Минимальный уровень масштаба слоя. |
opacity | число | да | change:opacity | Непрозрачность слоя. |
visible | логическое значение | да | change:visible | Значение свойства |
zIndex | число | undefined | да | change:zindex | Индекс Z слоя. |
Методы
-
changed() inherited
-
Увеличивает счетчик ревизий и отправляет событие 'change'.
-
dispatchEvent(event){boolean | undefined} inherited
-
Отправляет событие и вызывает всех слушателей, слушающих события этого типа. Параметр события может быть строкой или объектом со свойством
type.Name Type Description eventBaseEvent | string Объект события.
Returns:
falseif anyone called preventDefault on the event object or if any of the listeners returned false.
-
Получает значение.
Name Type Description keystring Имя ключа.
Returns:
Value.
-
getExtent(){Extent | undefined}
-
Возвращает
extentслоя илиundefined, если он будет виден независимо от экстента.Returns:
The layer extent.
-
Получить список имен свойств объекта.
Returns:
List of property names.
-
getMaxResolution(){number}
-
Возвращает максимальное разрешение слоя. Возвращает Infinity, если у слоя не установлено максимальное разрешение.
Returns:
The maximum resolution of the layer.
-
getMaxZoom(){number}
-
Возвращает максимальный уровень масштабирования слоя. Возвращает Infinity, если у слоя не установлен максимальный масштаб.
Returns:
The maximum zoom level of the layer.
-
getMinResolution(){number}
-
Возвращает минимальное разрешение слоя. Возвращает 0, если у слоя не установлено минимальное разрешение.
Returns:
The minimum resolution of the layer.
-
getMinZoom(){number}
-
Возвращает минимальный уровень масштабирования слоя. Возвращает -Infinity, если у слоя не установлен минимальный масштаб.
Returns:
The minimum zoom level of the layer.
-
getOpacity(){number}
-
Возвращает непрозрачность слоя (от 0 до 1).
Returns:
The opacity of the layer.
-
Получить объект всех имен и значений свойств.
Returns:
Object.
-
getRevision(){number} inherited
-
Получить номер версии для этого объекта. Каждый раз, когда объект изменяется, его номер версии будет увеличиваться.
Returns:
Revision.
-
getVisible(){boolean}
-
Возвращает значение свойства
visibleэтого слоя. Чтобы узнать, виден ли слой на карте, используйтеisVisible()вместо этого.Returns:
The value of thevisibleproperty of the layer.
-
getZIndex(){number | undefined}
-
Возвращает Z-индекс слоя, который используется для упорядочивания слоев перед отрисовкой. Возвращает undefined, если слой не управляется.
Returns:
The Z-index of the layer.
-
Прослушивать определенный тип события.
Name Type Description typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция прослушивателя.
Returns:
Unique key for the listener. If called with an array of event types as the first argument, the return will be an array of keys.
-
Однократное прослушивание события определённого типа.
Name Type Description typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Returns:
Уникальный ключ для обработчика. Если вызывается с массивом типов событий в качестве первого аргумента, возвращается массив ключей.
-
Устанавливает значение.
Name Type Description keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновить без генерации события.
-
setExtent(extent)
-
Устанавливает область видимости слоя. Если
undefined, слой будет видим при всех масштабах.Name Type Description extentExtent | undefined Область видимости слоя.
-
setMaxResolution(maxResolution)
-
Устанавливает максимальное разрешение, при котором слой видим.
Name Type Description maxResolutionnumber Максимальное разрешение слоя.
-
setMaxZoom(maxZoom)
-
Устанавливает максимальный уровень масштабирования (не включая), при котором слой видим. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника плиток.
Name Type Description maxZoomnumber Максимальный уровень масштабирования слоя.
-
setMinResolution(minResolution)
-
Устанавливает минимальное разрешение, при котором слой видим.
Name Type Description minResolutionnumber Минимальное разрешение слоя.
-
setMinZoom(minZoom)
-
Устанавливает минимальный уровень масштабирования (включая), при котором слой видим. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника плиток.
Name Type Description minZoomnumber Минимальный уровень масштабирования слоя.
-
setOpacity(opacity)
-
Устанавливает непрозрачность слоя, допустимые значения находятся в диапазоне от 0 до 1.
Name Type Description opacitynumber Непрозрачность слоя.
-
Устанавливает набор пар «ключ-значение». Обратите внимание, что это изменяет любые существующие свойства и добавляет новые (существующие свойства не удаляются).
Name Type Description valuesObject.<string, *> Значения.
silentboolean | undefined Обновить без генерации события.
-
setVisible(visible)
-
Устанавливает видимость слоя (
trueилиfalse).Name Type Description visibleboolean Видимость слоя.
-
setZIndex(zindex)
-
Устанавливает Z-индекс слоя, который используется для упорядочивания слоев перед отображением. Z-индекс по умолчанию равен 0.
Name Type Description zindexnumber Z-индекс слоя.
-
un(type, listener) inherited
-
Отменить прослушивание определенного типа события.
Имя Тип Описание typeстрока | Массив.<строка> Тип события или массив типов событий.
listenerфункция Функция-обработчик.
-
unset(ключ, немые) унаследованно
-
Сбросить свойство.
Имя Тип Описание keyстрока Имя ключа.
silentлогическое | 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