jakemarsh / Jmwhentapped

What is it?

JMWhenTapped is a simple little syntactical-sugar addition to all UIView objects, as well as any class that inherits from UIView. It allows you to assign touch-up, touch-down, tapped (touched down then up), double taps and two finger taps actions to a UIView object using a convenient blocks-style syntax. (Examples shown below).

Installation

Clone the repo. Add the JMWhenTapped folder to your iOS 4 project. #import "JMWhenTapped.h" wherever you'd like to use the syntax.

Examples & Usage

Use it like this:

[myView whenTapped:^{
	NSLog(@"I was tapped!");
}];

Or like this:

[myView whenTouchedDown:^{
	NSLog(@"I was touched down!");
}];

And also like this:

[myView whenTouchedUp:^{
	NSLog(@"I was touched up!");		
}];

This works the same way with double tap and two finger taps.

The Different Actions

The whenTapped: method should be used in cases where you simply want something to happen when the user taps on a view (i.e. you are concerned with performing some action when their finger is down then up, like changing to a "pressed" state.)

The whenDoubleTapped: method should be used when you want to check for double taps on your view.

The whenTwoFingerTapped: method should be used when you want to check for single taps made with two fingers (like in Maps.app).

The whenTouchedDown: method should be used when you want to trigger some action when the user touches down on your view.

The whenTouchedUp: method should be used when you want to trigger some action when the user touches up on your view.

Demo

Included in this repo is a demo Xcode project that illustrates a quick example of how to use JMWhenTapped.