---
title: "CooperativeGesturesHandler | JavaScript maps SDK"
description: "Documentation for MapTiler SDK"
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Class CooperativeGesturesHandler

A `CooperativeGestureHandler` is a control that adds cooperative gesture info when user tries to zoom in/out.

When the CooperativeGestureHandler blocks a gesture, it will emit a `cooperativegestureprevented` event.

#### Example[](#example)

```typescript
const map = new Map({
  cooperativeGestures: true
});
```

#### See[](#see)

[Example: cooperative gestures](https://maplibre.org/maplibre-gl-js/docs/examples/cooperative-gestures/)

#### Hierarchy ([View Summary](https://docs.maptiler.com/sdk-js/api-reference/hierarchy/#Externals.CooperativeGesturesHandler))

-   CooperativeGesturesHandler
    -   [CooperativeGesturesHandler](https://docs.maptiler.com/sdk-js/api-reference/classes/CooperativeGesturesHandler/)

#### Implements

-   [Handler](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/)

##### Index

### Constructors[](#constructors)

[constructor](#constructor)

### Methods[](#methods)

[disable](#disable) [enable](#enable) [isActive](#isactive) [isBypassed](#isbypassed) [isEnabled](#isenabled) [notifyGestureBlocked](#notifygestureblocked) [reset](#reset)

## Constructors[](#constructors-1)

### constructor[](#constructor)

-   new CooperativeGesturesHandler(  
        map: [MapLibreMap](https://docs.maptiler.com/sdk-js/api-reference/classes/MapLibreMap/),  
        options: boolean,  
    ): CooperativeGesturesHandler[](#constructorcooperativegestureshandler)
    
    #### Parameters
    
    -   map: [MapLibreMap](https://docs.maptiler.com/sdk-js/api-reference/classes/MapLibreMap/)
    -   options: boolean
    
    #### Returns CooperativeGesturesHandler
    

## Methods[](#methods-1)

### disable[](#disable)

-   disable(): void[](#disable-1)
    
    #### Returns void
    
    Implementation of [Handler](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/).[disable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/#disable)
    

### enable[](#enable)

-   enable(): void[](#enable-1)
    
    #### Returns void
    
    Implementation of [Handler](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/).[enable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/#enable)
    

### isActive[](#isactive)

-   isActive(): boolean[](#isactive-1)
    
    This is used to indicate if the handler is currently active or not. In case a handler is active, it will block other handlers from getting the relevant events. There is an allow list of handlers that can be active at the same time, which is configured when adding a handler.
    
    #### Returns boolean
    
    Implementation of [Handler](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/).[isActive](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/#isactive)
    

### isBypassed[](#isbypassed)

-   isBypassed(event: [MouseEvent](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.MouseEvent/) | [WheelEvent](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.WheelEvent/) | [PointerEvent](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.PointerEvent/)): boolean[](#isbypassed-1)
    
    #### Parameters
    
    -   event: [MouseEvent](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.MouseEvent/) | [WheelEvent](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.WheelEvent/) | [PointerEvent](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.PointerEvent/)
    
    #### Returns boolean
    

### isEnabled[](#isenabled)

-   isEnabled(): boolean[](#isenabled-1)
    
    #### Returns boolean
    
    Implementation of [Handler](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/).[isEnabled](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/#isenabled)
    

### notifyGestureBlocked[](#notifygestureblocked)

-   notifyGestureBlocked(  
        gestureType: "wheel\_zoom" | "touch\_pan",  
        originalEvent: [Event](https://docs.maptiler.com/sdk-js/api-reference/classes/Event/),  
    ): void[](#notifygestureblocked-1)
    
    #### Parameters
    
    -   gestureType: "wheel\_zoom" | "touch\_pan"
    -   originalEvent: [Event](https://docs.maptiler.com/sdk-js/api-reference/classes/Event/)
    
    #### Returns void
    

### reset[](#reset)

-   reset(): void[](#reset-1)
    
    `reset` can be called by the manager at any time and must reset everything to it's original state
    
    #### Returns void
    
    Implementation of [Handler](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/).[reset](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Handler/#reset)