# Leaflet.TouchHover

**Repository Path**: mirrors_mourner/Leaflet.TouchHover

## Basic Information

- **Project Name**: Leaflet.TouchHover
- **Description**: A plugin for adding hover-like interaction to Leaflet maps on mobile devices
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


Leaflet.TouchHover
==================

A plugin for adding hover-like interaction to Leaflet maps on mobile devices. Created by [Vladimir Agafonkin](https://github.com/mourner).

[Demo](http://mourner.github.io/Leaflet.TouchHover/demo/) (adapted from the [choropleth tutorial](http://leafletjs.com/examples/choropleth.html); view it on a mobile device)

## What it does

One problem with implementing hover interaction on mobile devices is that there are no `mouseover` and `mouseout` equivalents on mobile.
The spec describes `touchenter` and `touchleave` events for that but they are not supported in iOS or Android.

Another problem is that touch-and-move interaction for hovering on features conflicts with the standard dragging functionality in interactive maps.

This plugin solves both problems by introducing **a button control that switches the map to "hover" mode**,
in which dragging and pinch zoom are disabled, and all the mouse hover events actually work when you touch and move over features as they would on a desktop browser.

If you have a Leaflet app that's designed to work with `mouseover`, `mouseout` and `mousemove` events on desktop browser, it will become usable on mobile with this plugin out of the box.

## Requirements

[Leaflet](http://leafletjs.com) 0.6.2 and later.

## Usage

```js
if (L.Browser.touch) {
	L.control.touchHover().addTo(map);
}
```

This code will add a hover mode toggle button on mobile devices.
You can customize its look by adding styles to `leaflet-control-touchhover`, `leaflet-control-touchhover-toggle`, `leaflet-control-touchhover-toggled` classes.

## License

Licensed under [The MIT License](http://opensource.org/licenses/MIT).