W3cubDocs

/Angular.js 1.6

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.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.6.5/docs/api/ngTouch