andreamazz / uitextfield-shake

UITextField category that adds shake animation

UITextField category that adds a shake animation like the password field of the OsX login screen.

Screenshot

Setup with CocoaPods

pod 'UITextField+Shake', '~> 1.2'

Import UITextField+Shake.h in your controller's header file, or UITextField_Shake if you are using the use_frameworks! directive.

Setup with Carthage

github "andreamazz/UITextField-Shake"

Usage

In Objective-C

// Shake
[[self.textField] shake];

// Shake with the default speed
[self.textField shake:10   // 10 times
            withDelta:5    // 5 points wide
];

// Shake with a custom speed
[self.textField shake:10   // 10 times
            withDelta:5    // 5 points wide
                speed:0.03 // 30ms per shake
];

// Shake with a custom speed and direction
[self.textField shake:10   // 10 times
            withDelta:5    // 5 points wide
                speed:0.03 // 30ms per shake
       shakeDirection:ShakeDirectionVertical
];

In Swift

// Shake
self.textField.shake()

// Shake with the default speed
self.textField.shake(10,              // 10 times
                     withDelta: 5.0   // 5 points wide
)

// Shake with a custom speed
self.textField.shake(10,              // 10 times
                     withDelta: 5.0,  // 5 points wide
                     speed: 0.03      // 30ms per shake
)

// Shake with a custom speed and direction
self.textField.shake(10,              // 10 times
                     withDelta: 5.0,  // 5 points wide
                     speed: 0.03,     // 30ms per shake
                     shakeDirection: ShakeDirection.Vertical
)

Completion Handler

You can also pass a completion block that will be performed as soon as the shake animation stops

- (void)shake:(int)times withDelta:(CGFloat)delta completion:(void((^)()))handler;
- (void)shake:(int)times withDelta:(CGFloat)delta speed:(NSTimeInterval)interval completion:(void((^)()))handler;
- (void)shake:(int)times withDelta:(CGFloat)delta speed:(NSTimeInterval)interval shakeDirection:(ShakeDirection)shakeDirection completion:(void((^)()))handler;

or in Swift using the trailing closure syntax:

textField.shake(10, withDelta: 5) {
    println("done")
}

Author

Andrea Mazzini. I'm available for freelance work, feel free to contact me.

Want to support the development of these free libraries? Buy me a coffee ☕️ via Paypal.

Contributors

Thanks to everyone kind enough to submit a pull request.

MIT License

Copyright (c) 2017 Andrea Mazzini. All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

uitextfield-shake's Issues

Problem with CocoaPod Update

I attempted to perform a cocoapod update in a current project and got an error. I am enough of a newbie at cocoapods that I have no clue what it means or what needs to be done to fix it. Can you help?

Update all pods
Analyzing dependencies
Downloading dependencies
... [Installing other Pods]...
Installing UITextField+Shake (0.2)
[!] Pod::Executable remote update

error: cannot open FETCH_HEAD: Permission denied

UITextField-Shake for Swift

I have converted this repo in swift and you can find it here

Functions containing blocks are not available in Swift.

These three methods available below are not displayed by the auto-completion when using Swift:

- (void)shake:(int)times withDelta:(CGFloat)delta completion:(void((^)()))handler;
- (void)shake:(int)times withDelta:(CGFloat)delta speed:(NSTimeInterval)interval completion:(void((^)()))handler;
- (void)shake:(int)times withDelta:(CGFloat)delta speed:(NSTimeInterval)interval shakeDirection:(ShakeDirection)shakeDirection completion:(void((^)()))handler;

Nonetheless the others which do not use blocks are usable and displayed by the auto-completion tool in the last version of Xcode. I tried to call them manually in a Swift project (the three methods above) but I was not successful.

So to by-pass this problem I had to call these functions from an Objective-C class which itself was called by a Swift class.

So you should fix this problem by rewriting this API in Swift.

Thank you in advance.

Best regards.

A summary for: Library translated by @King-Wizard from Objective-C to Swift.

http://pastebin.com/wiKxkiDv

Position Independent Executable

First, thank you for this great work, it's extremely handy.

I am having warnings when uploading my app to the store after adding this framework from Cocoa Pods. They say the app is no longer a PIE and after reading here it seems it can be caused by other libraries.

This is the only pod on this project so I'm almost certain it is the cause. I have tried the suggestions from the link above and while the command line tool shows the app has the PIE flag I continue to receive app store warnings. So it may also be an App store issue.

Has anyone else reported this? I will continue searching on my end

UIView category

Not really an issue, but is there a reason this isn't implemented directly on UIView? I think some other subclasses (like UITableViewCell for example) could benefit from it.

Warning - This block declaration is not a prototype

I am getting this warning "This block declaration is not a prototype", I am using Swift 4 with Xcode 9.2 (9C40b).

This warning I am getting in

UITextField+Shake.m

on line number 41

Correct to use 'shakeDirection'

- (void)shake:(int)times withDelta:(CGFloat)delta andSpeed:(NSTimeInterval)interval shakeDirection:(ShakeDirection)shakeDirection
{
    [self shake:times withDelta:delta andSpeed:interval shakeDirection: shakeDirection completion:nil];
}