User interaction handlers
Items related to the ways in which the map responds to user input.
BoxZoomHandler
The BoxZoomHandler
allows the user to zoom the map to fit within a bounding box.
The bounding box is defined by clicking and holding shift
while dragging the cursor.
Methods
ScrollZoomHandler
The ScrollZoomHandler
allows the user to zoom the map by scrolling.
Methods
Enables the "scroll to zoom" interaction.
Parameters
(Object?)
Options
object.
options.around | If "center" is passed, map will zoom around center of map |
---|
Example
DragPanHandler
src/ui/handler/shim/drag_pan.ts
The DragPanHandler
allows the user to pan the map by clicking and dragging
the cursor.
Methods
Enables the "drag to pan" interaction.
Parameters
(Object?)
Options
object
options.linearity
default: 0
|
factor used to scale the drag velocity |
---|---|
options.easing
default: bezier(0,0,0.3,1)
|
easing function applled to
map.panTo
when applying the drag.
|
options.maxSpeed
default: 1400
|
the maximum value of the drag velocity. |
options.deceleration
default: 2500
|
the rate at which the speed reduces after the pan ends. |
Example
DragRotateHandler
src/ui/handler/shim/drag_rotate.ts
The DragRotateHandler
allows the user to rotate the map by clicking and
dragging the cursor while holding the right mouse button or ctrl
key.
Methods
KeyboardHandler
The KeyboardHandler
allows the user to zoom, rotate, and pan the map using
the following keyboard shortcuts:
=
/+
: Increase the zoom level by 1.Shift-=
/Shift-+
: Increase the zoom level by 2.-
: Decrease the zoom level by 1.Shift--
: Decrease the zoom level by 2.- Arrow keys: Pan by 100 pixels.
Shift+⇢
: Increase the rotation by 15 degrees.Shift+⇠
: Decrease the rotation by 15 degrees.Shift+⇡
: Increase the pitch by 10 degrees.Shift+⇣
: Decrease the pitch by 10 degrees.
Methods
Disables the "keyboard pan/rotate" interaction, leaving the "keyboard zoom" interaction enabled.
Example
DoubleClickZoomHandler
src/ui/handler/shim/dblclick_zoom.ts
The DoubleClickZoomHandler
allows the user to zoom the map at a point by
double clicking or double tapping.
Methods
TouchZoomRotateHandler
src/ui/handler/shim/touch_zoom_rotate.ts
The TouchZoomRotateHandler
allows the user to zoom and rotate the map by
pinching on a touchscreen.
They can zoom with one finger by double tapping and dragging. On the second tap, hold the finger down and drag up or down to zoom in or out.
Methods
Disables the "pinch to rotate" interaction, leaving the "pinch to zoom" interaction enabled.
Example
Enables the "pinch to rotate and zoom" interaction.
Parameters
(Object?)
Options
object.
options.around | If "center" is passed, map will zoom around the center |
---|
Example
TouchPitchHandler
src/ui/handler/touch_zoom_rotate.ts
The TouchPitchHandler
allows the user to pitch the map by dragging up and down with two fingers.
Parameters
(Map)