TestsTested | ✓ |
LangLanguage | Obj-CObjective C |
License | MIT |
ReleasedLast Release | Jun 2015 |
Maintained by Ayaka Nonaka, Dasmer Singh, Mark Adams, Mark Adams, Lionel Alves.
VENCalculatorInputView is the calculator keyboard that is used in the Venmo iOS app. Available for iOS 6 and beyond. Enjoy.
The easiest way to get started is to use CocoaPods. Just add the following line to your Podfile:
pod 'VENCalculatorInputView', '~> 1.5'
You can choose to use just VENCalculatorInputView
(only the keyboard) and define your own behavior or use VENCalculatorInputTextField
(keyboard + text field with money calculation built in).
Find the UITextField
or UITextView
that you want to display the keyboard and set its inputView
to an instance of VENCalculatorInputView
.
myTextField.inputView = [VENCalculatorInputView new];
This will have VENCalculatorInputView
display when myTextField
becomes firstResponder
instead of the system keyboard.
<VENCalculatorInputViewDelegate>
methods.First, have a class implement the <VENCalculatorInputViewDelegate>
protocol and set myTextField.inputView.delegate
to an instance of that class.
Next, implement the delegate method that handles keyboard input:
- (void)calculatorInputView:(VENCalculatorInputView *)inputView didTapKey:(NSString *)key {
NSLog(@"Just tapped key: %@", key);
// Handle the input. Something like [myTextField insertText:key];
}
Finally, implement the delegate method that handles the backspace key:
- (void)calculatorInputViewDidTapBackspace:(VENCalculatorInputView *)calculatorInputView {
NSLog(@"Just tapped backspace.");
// Handle the backspace. Something like [myTextField deleteBackward];
}
Try it!
You can read more about custom keyboards in Apple’s documentation.
All you need to do is use VENCalculatorInputTextField
instead of UITextField
and use it like normal text field. It will automagically handle the input and make calculations. Take a look at out our VENCalculatorInputViewSample
project.
Different regions use different symbols as their decimal separator (e.g. .
, ,
). By default, VENCalculatorInputView
and VENCalculatorInputTextField
use the current locale of the device. You can change it by setting the locale
property.
We’ve written some tests. You can run them by opening the project in Xcode and hitting Command-U
.
We’d love to see your ideas for improving this library! The best way to contribute is by submitting a pull request. We’ll do our best to respond to your patch as soon as possible. You can also submit a new GitHub issue if you find bugs or have questions.
Please make sure to follow our general coding style and add test coverage for new features!