{"title":"Save Time and Code With JMWhenTapped","html_url":"https://deallocatedobjects.com/posts/jmwhentapped","source_url":"","markdown_content":"I've just released a new little helper library for iOS development. It's called `JMWhenTapped`. It's 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, and tapped (touched down then up) actions to a `UIView` object using a convenient blocks-style syntax.\r\n\r\n### Installation\r\n\r\nClone [the repo](http://github.com/jakemarsh/JMWhenTapped). Add the `JMWhenTapped` folder to your iOS 4 project. `#import \"JMWhenTapped.h\"` wherever you'd like to use the syntax.\r\n\r\n### Examples & Usage\r\n\r\nUse it like this:\r\n\r\n``` objc\t\r\n[myView whenTapped:^{\r\n\tNSLog(@\"I was tapped!\");\r\n}];\r\n```\r\n\t\r\nOr like this:\r\n\r\n``` objc\r\n[myView whenTouchedDown:^{\r\n\tNSLog(@\"I was touched down!\");\r\n}];\r\n```\r\n\t\r\nAnd also like this:\r\n\r\n``` objc\r\n[myView whenTouchedUp:^{\r\n\tNSLog(@\"I was touched up!\");\t\t\r\n}];\r\n```\r\n\r\n### The Different Actions\r\n\r\nThe `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.)\r\n\r\nThe `whenTouchedDown:` method should be used when you want to trigger some action when the user touches down on your view.\r\n\r\nThe `whenTouchedUp:` method should be used when you want to trigger some action when the user touches up on your view.\r\n\r\n### Demo\r\n\r\nIncluded in [the repo](http://github.com/jakemarsh/JMWhenTapped) is a demo Xcode project that illustrates a quick example of how to use `JMWhenTapped`.","html_content":"

I’ve just released a new little helper library for iOS development. It’s called JMWhenTapped. It’s 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, and tapped (touched down then up) actions to a UIView object using a convenient blocks-style syntax.

\n\n

Installation

\n\n

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

\n\n

Examples & Usage

\n\n

Use it like this:

\n
Objective-C
[myView whenTapped:^{\n    NSLog(@\"I was tapped!\");\n}];
\n

Or like this:

\n
Objective-C
[myView whenTouchedDown:^{\n    NSLog(@\"I was touched down!\");\n}];
\n

And also like this:

\n
Objective-C
[myView whenTouchedUp:^{\n    NSLog(@\"I was touched up!\");        \n}];
\n

The Different Actions

\n\n

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.)

\n\n

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

\n\n

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

\n\n

Demo

\n\n

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

","created_at":"2013-11-16T05:10:25.686Z","updated_at":"2013-11-16T05:10:25.686Z"}