Latest 0.1.0
License MIT
Platforms ios 8.0

CI Status

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



You can install JMMaskTextField with CocoaPods

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


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


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!


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!


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;


Jota Melo, [email protected]


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

Latest podspec

    "name": "JMMaskTextField",
    "version": "0.1.0",
    "summary": "JMMaskTextField - text field masking the easy way",
    "description": "JMMaskTextField makes creating masked UITextFields as easy as setting a mask string, like (000) 000-0000 for phone numbers, or AAA-0000 for a Brazilian license plate.nJMMaskTextField supports pasting, inserting and deleting from the middle.",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Jota Melo": "[email protected]"
    "source": {
        "git": "",
        "tag": "0.1.0"
    "social_media_url": "",
    "platforms": {
        "ios": "8.0"
    "source_files": "JMMaskTextField/Classes/**/*"

Pin It on Pinterest

Share This