Skip to content

Latest commit

 

History

History
89 lines (61 loc) · 3.9 KB

README.md

File metadata and controls

89 lines (61 loc) · 3.9 KB
Raw

JMMaskTextField

CI Status Version License Platform

Back in my JavaScript days (oh what dark ages) it was quite simple to apply a mask to an input with some jQuery plugin, you just had to set the mask to something like (999) 999-9999 and you had a great masked input for a phone number. I never found anything that simple on iOS. Some libs required you to write a regex pattern and other crazy stuff. Sure, that can be useful for more complex cases, but I just wanted something simple and straightforward. From that need came JMMaskTextField.

JMMaskTextField allows you to mask your UITextField by simply setting a mask pattern string. Mask characters are:

  • A for letters
  • 0 for numbers

So for a Brazilian license plate, which has 3 letters, a dash and then 4 numbers, the mask would be: AAA-0000.

JMMaskTextField also handles pasting, inserting and deleting from the middle.

There's also a Swift version

Installation

CocoaPods

You can install JMMaskTextField with CocoaPods

  • Add this line to your Podfile pod "JMMaskTextField"
  • Run pod install

Manual

Just drop the JMMaskTextField folder in your project and you're all set!

Usage

Funcionality is broken down into 2 classes:

  • JMStringMask - all the string masking functionality. You can use this yourself outside of the JMMaskTextField.
  • JMMaskTextField - the UITextField subclass, handling all editing events. Uses an instance of JMStringMask.

Interface Builder

Set the class of your text field to JMMaskTextField in the Identity Inspector. And then on the Attributes Inspector set your mask. And that's it!

Code

Initialize an instance of JMMaskTextField and set the mask property:

JMMaskTextField *maskTextField = [[JMMaskTextField alloc] initWithFrame:CGRectZero];
maskTextField.maskString = @"(00) 0 0000-0000";

And that's it!

JMStringMask

You can use the string masking functionality outside of the text field. Usage is also simple:

JMStringMask *mask = [JMStringMask initWithMask:@"00000-000"];
NSString *maskedString = [mask maskString:@"30310360"]; // returns "30310-360"
NSSring *unmaskedString = [mask unmaskString:maskedString]; // returns "30310360"

Changing the mask while editing

In Brazil we a problem: cell phone numbers are 9 digits (and until recently not all of them were 9 digits), and landlines are 8 digits. That creates a problem with masking. JMMaskTextField supports changing the mask while editing. So when we identify the user typed a 9 digit number, we switch the mask to the longer format. If they delete a digit, we go back to the original mask. An example:

- (BOOL)textField:(JMMaskTextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string
{
    NSString *newText = [textField.text stringByReplacingCharactersInRange:range withString:string];

    // 11 with the area code
    if ([textField.mask unmaskString:newText].length >= 11) {
        textField.maskString = @"(00) 0 0000-0000";
    } else {
        textField.maskString = @"(00) 0000-0000";
    }

    return YES;
}

Author

Jota Melo, [email protected]

License

JMMaskTextField is available under the MIT license. See the LICENSE file for more info.