nglar / ngTouch

A angular module to add directives for touch devices.
MIT License
53 stars 30 forks source link
angular html javascript ngtouch touch-devices

No longer maintained, would you be our new maintainer? Let us know at mark@ulties.com.

nglar - ngTouch

A angular module to add directives for touch devices.

Build Status StyleCI Status Dependencies Dev Dependencies License

Info

Version: 1.0.2
Author: Mark Topper [Facebook] [Github] [Twitter]
Website: ulties.com
Email: mark@ulties.com

Installing/Loading

Install using Bower

Install using bower:

bower install ngtouch --save

Install using NPM

Install using npm:

npm install ngtouch --save

Go to NPM page for this package.

Loading

Load the file to you HTML header:

<script type="text/javascript" src="https://github.com/nglar/ngTouch/raw/master/path/to/components/ngtouch/build/ngTouch.min.js"></script>

Usage

You must include the ngTouch dependency on your angular module:

var app = angular.module("demoapp", ["ngTouch"]);

Then in your HTML you can use:

<div ng-touchmove="someFunction()" ng-touchstart="someFunction()" ng-touchend="someFunction()"></div>

ng-touchstart

Once a touch device start touching, this event will be called.

Here is a usage example:

yourController.js

$scope.onTouchstart = function() {
console.log($scope.event); // the event object
console.log('touchstart event called');
}

yourView.html

<div ng-touchstart="onTouchstart()"></div>

Get ngTouchstart standalone.

ng-touchend

Once a touch device end touching, this event will be called.

Here is a usage example:

yourController.js

$scope.onTouchend = function() {
console.log($scope.event); // the event object
console.log('touchend event called');
}

yourView.html

<div ng-touchend="onTouchend()"></div>

Get ngTouchend standalone.

ng-touchmove

Whenever a touch device is touched and moving.

Here is a usage example:

yourController.js

$scope.onTouchmove = function() {
console.log($scope.event); // the event object
console.log('touchmove event called');
}

yourView.html

<div ng-touchmove="onTouchmove()"></div>

Get ngTouchmove standalone.

ng-tap

Whenever a touch device is tapped without moved around.

Here is a usage example:

yourController.js

$scope.onTap = function() {
console.log($scope.event); // the event object
console.log('tap event called');
}

yourView.html

<div ng-tap="onTap()"></div>

Get ngTap standalone.

Links

The following is a list of libraries that extend ngTouch:

Contact me at mark@ulties.com to get yours added.

The following is a list of libraries that requires by ngTouch:

The following is a list of alternatives for ngTouch:

Tests

From the project directory, tests can be ran using gulp test

Contributing

Thank you for considering contributing! The contribution guide can be found in the contributions.md.

Security Vulnerabilities

If you discover a security vulnerability within ngTouch, please send an e-mail to Mark Topper at mark@ulties.com. All security vulnerabilities will be promptly addressed.

License

Released under the MIT License - see license.txt for details.