Improve this Doc

# `ngTouch`

## Installation

First, get the file:

- Google CDN e.g.

      "//ajax.googleapis.com/ajax/libs/angularjs/X.Y.Z/angular-touch.js"

- NPM e.g.

      npm install --save angular-touch@X.Y.Z

  or

      yarn add angular-touch@X.Y.Z

- Bower e.g.

      bower install angular-touch#X.Y.Z

- code.angularjs.org (discouraged for production use) e.g.

      "//code.angularjs.org/X.Y.Z/angular-touch.js"

where X.Y.Z is the AngularJS version you are running.

Then, include `angular-touch.js` in your HTML:

    <script src="path/to/angular.js"></script>
    <script src="path/to/angular-touch.js"></script>

Finally, load the module in your application by adding it as a dependent module:

    angular.module('app', ['ngTouch']);

With that you're ready to get started!

# ngTouch

The `ngTouch` module provides touch events and other helpers for touch-enabled devices. The implementation is based on jQuery Mobile touch event handling (jquerymobile.com).

See `$swipe` for usage.

## Module Components

### Directive

Name | Description
--- | ---
ngClick | A more powerful replacement for the default ngClick designed to be used on touchscreen devices. Most mobile browsers wait about 300ms after a tap-and-release before sending the click event. This version handles them immediately, and then prevents the following click event from propagating.
ngSwipeLeft | Specify custom behavior when an element is swiped to the left on a touchscreen device. A leftward swipe is a quick, right-to-left slide of the finger. Though ngSwipeLeft is designed for touch-based devices, it will work with a mouse click and drag too.
ngSwipeRight | Specify custom behavior when an element is swiped to the right on a touchscreen device. A rightward swipe is a quick, left-to-right slide of the finger. Though ngSwipeRight is designed for touch-based devices, it will work with a mouse click and drag too.

### Service

Name | Description
--- | ---
$swipe | The `$swipe` service is a service that abstracts the messier details of hold-and-drag swipe behavior, to make implementing swipe-related directives more convenient.
$touch | Provides the `ngClickOverrideEnabled` method.

### Provider

Name | Description
--- | ---
$touchProvider | The `$touchProvider` allows enabling / disabling ngTouch's ngClick directive.