ol/interaction/DragZoom~DragZoom
import DragZoom from 'ol/interaction/DragZoom.js';
Позволяет пользователю изменять масштаб карты, нажимая и перетаскивая по карте, обычно в сочетании с ol/events/condition, ограничивающим это действием до момента удержания клавиши, по умолчанию Shift.
Для изменения стиля рамки используйте CSS и селектор .ol-dragzoom, или свой пользовательский селектор, настроенный с помощью className.
-
new DragZoom(options)
-
Имя Тип Описание classNamestring (defaults to 'ol-dragzoom') Имя класса CSS для стилизации рамки.
conditionCondition | undefined Функция, принимающая
MapBrowserEventи возвращающая булево значение, указывающее, должно ли обрабатываться это событие. По умолчаниюshiftKeyOnly.durationnumber (defaults to 200) Продолжительность анимации в миллисекундах.
outboolean (defaults to false) Использовать взаимодействие для уменьшения масштаба.
minAreanumber (defaults to 64) Минимальная площадь рамки в пикселях. Это значение используется родительской функцией по умолчанию
boxEndCondition.Вызываемые события:
-
boxcancel(DragBoxEvent) - Срабатывает при отмене перетаскивания рамки. -
boxdrag(DragBoxEvent) - Срабатывает при перетаскивании, когда рамка активна. -
boxend(DragBoxEvent) - Срабатывает по завершении перетаскивания рамки. -
boxstart(DragBoxEvent) - Срабатывает при начале перетаскивания рамки. -
change(BaseEvent) - Общее событие изменения. Срабатывает при увеличении счётчика изменений. -
change:active(ObjectEvent) -
error(BaseEvent) - Общее событие об ошибке. Срабатывает при возникновении ошибки. -
propertychange(ObjectEvent) - Срабатывает при изменении свойства.
-
Расширяет
Наблюдаемые свойства
| Имя | Тип | Настраиваемое | ObjectEvent тип | Описание |
|---|---|---|---|---|
active | boolean | да | change:active |
|
Методы
-
changed() inherited
-
Увеличивает счётчик ревизий и отправляет событие 'change'.
-
dispatchEvent(event){boolean | undefined} inherited
-
Отправляет событие и вызывает всех слушателей, ожидающих события этого типа. Параметр события может быть строкой или объектом с свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-то вызвал preventDefault для объекта события или если любой из слушателей вернул false.
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getActive(){boolean} inherited
-
Возвращает, активен ли в данный момент интерактивный элемент.
Возвращает:
true, если интерактивный элемент активен,falseв противном случае.
-
Возвращает геометрию последней нарисованной области.
Возвращает:
Геометрию.
-
Получить список имён свойств объекта.
Возвращает:
Список имён свойств.
-
Получить карту, связанную с этим интерактивным элементом.
Возвращает:
Карту.
-
getPointerCount(){number} inherited
-
Возвращает текущее количество указателей, участвующих во взаимодействии, например,
2, когда используются два пальца.Возвращает:
Количество указателей.
-
Получить объект всех имён и значений свойств.
Возвращает:
Объект.
-
getRevision(){number} inherited
-
Получить номер версии этого объекта. Каждый раз, когда объект изменяется, его номер версии увеличивается.
Возвращает:
Номер ревизии.
-
handleEvent(mapBrowserEvent){boolean} inherited
-
Обрабатывает событие
map browser eventи может вызывать другие функции, если обнаружены последовательности событий, такие как, например, 'drag' или 'down-up' и т. д.Имя Тип Описание mapBrowserEventMapBrowserEvent Событие браузера карты.
Возвращает:
falseдля остановки распространения события.
-
Прислушиваться к определённому типу события.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-слушатель.
Возвращает:
Уникальный ключ для слушателя. Если вызвана с массивом типов событий в качестве первого аргумента, возвращаемый результат будет массивом ключей.
-
Прослушать событие определенного типа один раз.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ для обработчика. Если в качестве первого аргумента передан массив типов событий, возвращается массив ключей.
-
set(key, value, silent) inherited
-
Устанавливает значение.
Имя Тип Описание keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновить без срабатывания события.
-
setActive(active) inherited
-
Активировать или деактивировать взаимодействие.
Имя Тип Описание activeboolean Активирован.
-
setProperties(values, silent) inherited
-
Устанавливает коллекцию пар ключ-значение. Обратите внимание, что это изменяет любые существующие свойства и добавляет новые (это не удаляет какие-либо существующие свойства).
Имя Тип Описание valuesObject.<string, *> Значения.
silentboolean | undefined Обновить без срабатывания события.
-
un(type, listener) inherited
-
Отменить прослушивание события определенного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
-
unset(key, silent) inherited
-
Удаляет свойство.
Имя Тип Описание 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_interaction_DragZoom-DragZoom.html