Input masks restrict data input and allow you to guide users to enter correct values.
Check out our wiki for quick start and further reading.
- Apply formatting to your text fields, see examples
- Filter out nonessential symbols (e.g. extract
0123456
from+1 (999) 012-34-56
) - For international phone numbers
- guess the country from the entered digits
- apply corresponding value restrictions (e.g. a πΊπΈUS phone will have a format like
+1 201 456-7890
)
- Apply number/currency formatting
- SwiftUI support
- macOS support
- Phone numbers:
+1 ([000]) [000] [00] [00]
- Dates:
[00]{.}[00]{.}[9900]
- Serial numbers:
[AA]-[00000099]
- IPv4:
[099]{.}[099]{.}[099]{.}[099]
- Visa/MasterCard numbers:
[0000] [0000] [0000] [0000]
- UK IBAN:
GB[00] [____] [0000] [0000] [0000] [00]
dependencies: [
.Package(url: "https://github.com/RedMadRobot/input-mask-ios", majorVersion: 7)
]
pod 'InputMask'
git clone
this repository;- Add
InputMask.xcodeproj
into your project/workspace; - Go to your target's settings, add
InputMask.framework
under theEmbedded Binaries
section - For
ObjC
projects:- (~Xcode 8.x) make sure
Build Options
hasEmbedded Content Contains Swift Code
enabled; - import bridging header.
- (~Xcode 8.x) make sure
Please take a closer look at our Known issues section before you incorporate our library into your project.
For your bugreports and feature requests please file new issues via GitHub.
Should you have any questions, please search for closed issues or ask questions at StackOverflow with the input-mask
tag.
UITextField
with assigned MaskedTextFieldDelegate
object won't issue UITextFieldTextDidChange
notifications and editingChanged
control events. This happens due to the textField(_:shouldChangeCharactersIn:replacementString:)
method implementation, which always returns false
.
Consider using following workaround in case if you do really need to catch editing events:
class NotifyingMaskedTextFieldDelegate: MaskedTextFieldDelegate {
weak var editingListener: NotifyingMaskedTextFieldDelegateListener?
override func textField(
_ textField: UITextField,
shouldChangeCharactersIn range: NSRange,
replacementString string: String
) -> Bool {
defer {
self.editingListener?.onEditingChanged(inTextField: textField)
}
return super.textField(textField, shouldChangeCharactersIn: range, replacementString: string)
}
}
protocol NotifyingMaskedTextFieldDelegateListener: class {
func onEditingChanged(inTextField: UITextField)
}
Please, avoid at all costs sending SDK events and notifications manually.
Interface Builder struggles to support modules imported in a form of a dynamic framework. For instance, custom views annotated as IBDesignable, containing IBInspectable and IBOutlet fields aren't recognized properly from the drag'n'dropped *.framework.
In case you are using our library as a Carthage-built dynamic framework, be aware you won't be able to easily wire your MaskedTextFieldDelegate
objects and their listeners from storyboards in your project. There is a couple of workarounds described in the corresponding discussion, though.
Also, consider filing a radar to Apple, like this one.
When you cut text, characters get deleted yet you won't be able to paste them somewhere as they aren't actually in your pasteboard.
iOS hardwires UIMenuController
's cut action to the UITextFieldDelegate
's textField(_:shouldChangeCharactersIn:replacementString:)
return value. This means "Cut" behaviour actually depends on the ability to edit the text.
Bad news are, our library returns false
in textField(_:shouldChangeCharactersIn:replacementString:)
, and heavily depends on this false
. It would require us to rewrite a lot of logic in order to change this design, and there's no guarantee we'll be able to do so.
Essentially, there's no distinct way to differentiate "Cut selection" and "Delete selection" actions on the UITextFieldDelegate
side. However, you may consider using a workaround, which will require you to subclass UITextField
overriding its cut(sender:)
method like this:
class UITextFieldMonkeyPatch: UITextField {
override func cut(_ sender: Any?) {
copy(sender)
super.cut(sender)
}
}
From our library perspective, this looks like a highly invasive solution. Thus, in the long term, we are going to investigate a "costly" method to bring the behaviour matching the iOS SDK logic. Yet, here "long term" might mean months.
Shortly after new text is being pasted from the clipboard, every UITextInput
receives a new value for its selectedTextRange
property from the system. This new range is not consistent with the formatted text and calculated caret position most of the time, yet it's being assigned just after set caretPosition
call.
To ensure correct caret position is set, it might be assigned asynchronously (presumably after a vanishingly small delay), if caret movement is set to be non-atomic; see MaskedTextFieldDelegate.atomicCursorMovement
property.
In case you are wondering why do we have two separate UITextFieldDelegate
and UITextViewDelegate
implementations, the answer is simple: prior to iOS 11 UITextField
and UITextView
had different behaviour in some key situations, which made it difficult to implement common logic.
Both had the same bug with the UITextInput.beginningOfDocument
property, which rendered impossible to use the generic UITextInput
protocol UITextField
and UITextView
have in common.
Since iOS 11 most of the things received their fixes (except for the UITextView
edge case). In case your project is not going to support anything below 11, consider using the modern MaskedTextInputListener
.
These folks rock:
- Mikhail while366 Zhadko
- Sergey SergeyCHiP Germanovich
- Luiz LuizZak Fernando
- Ivan vani Vavilov
- Diego diegotl Trevisan
- Martin martintreurnicht Treurnicht
- Alexander CFIFok Kurilovich
The library is distributed under the MIT LICENSE.