MaskedFormatter

1.0.1

Create fully customizable masks for texts.
Columbina/MaskedFormatter

What's New

v1.0.1

2021-10-31T11:44:35Z

What's Changed

  • Add support to Swift 5.2 in package manifest by @Edudjr in #1

New Contributors

  • @Edudjr made their first contribution in #1

Full Changelog: v1.0.0...v1.0.1

Columbina's Masked Formatter

example workflow

A fully customizable formatter used to create masks for texts.

let mask = "##/$$-@@"

let rules = [
    MaskedFormatter.Rule(maskCharacter: "#", validation: { $0.isNumber }),
    MaskedFormatter.Rule(maskCharacter: "$", validation: { $0.isLetter }),
    MaskedFormatter.Rule(maskCharacter: "@", validation: { (Int(String($0)) ?? 0) >= 5 })
]

let maskedFormatter = MaskedFormatter(mask: mask, rules: rules)

let input = "123ABC456"
let output = maskedFormatter.string(for: input)

print(output!)
// "12/AB-56"

Quick start

1. Import the module

import MaskedFormatter

2. Define a mask

For instance, an "expiration date" mask, commonly used for credit card forms, can be defined as such:

let mask = "##/##"

3. Define the rules

Using the same example for an "expiration date" mask, this is how our rule would look like:

let rule = MaskedFormatter.Rule(maskCharacter: "#", validation: { $0.isNumber })

4. Initiate a MaskedFormatter

let maskedFormatter = MaskedFormatter(mask: mask, rules: [rule])

5. Apply formatter

let input = "1234"
let output = maskedFormatter.string(for: input)
print(output!)
// "12/34"

Tips

Create your own formatters

For instance, by inheriting MaskedFormatter:

class CreditCardFormatter: MaskedFormatter {
    init() {
        let mask = "#### #### #### ####"
        let rule = MaskedFormatter.Rule(maskCharacter: "#", validation: { $0.isNumber })
        super.init(mask: mask, rules: [rule])
    }
    ...
}

Apply to UITextField

Mask a UITextField in "realtime" by listening to changes in the textfield:

let textField = UITextField()
textField.addTarget(self, 
                    action: #selector(textFieldDidChange(_:)),
                    for: .editingChanged)

...
@objc func textFieldDidChange(_ textField: UITextField) {
    textField.text = maskedFormatter.string(for: textField.text)
}

Apply to SwiftUI's TextField

Mask a TextField in "realtime" through onChange:

@State var text: String
...
TextField(placeholder, text: $text)
    .onChange(of: text) { value in
        text = maskedFormatter.string(for: text) ?? ""
    }

More details

Rule

MaskedFormatter.Rule(maskCharacter: Character, validation: @escaping (Character) -> Bool)

Rules will tell the formatter which characters from the mask are supposed to be replaced by what (letter, number, etc) In our "expiration date" mask example (##/##), we have two different characters, # and /. We want to replace #, thus we will create a rule for that character.

MaskedFormatter.Rule(maskCharacter: "#", validation: { ... })

In order to tell which input is valid for that specific character, we use the validation parameter. This parameter receives a Character and returns a Bool:

MaskedFormatter.Rule(maskCharacter: "#", validation: { (char: Character) -> Bool in
    ...
})

In our example, we want the # character to be replaced by a number, so we can check char and see if it is a number:

MaskedFormatter.Rule(maskCharacter: "#", validation: { (char: Character) -> Bool in
    char.isNumber
})

Now we can use this rule in one or more MaskedFormatters:

let rule = MaskedFormatter.Rule(maskCharacter: "#", validation: { $0.isNumber })
let formatter1 = MaskedFormatter(mask: "##", rules: [rule])
let formatter2 = MaskedFormatter(mask: "#/#", rules: [rule])

Description

  • Swift Tools 5.2.0
View More Packages from this Author

Dependencies

  • None
Last updated: Mon Mar 18 2024 15:03:55 GMT-0900 (Hawaii-Aleutian Daylight Time)