Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Easily assign touch down, touch up, and tapped actions to UIViews using blocks.
Objective-C
Branch: master

README.markdown

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.

Something went wrong with that request. Please try again.