Elegant SwiftUI phone number textField.
Get Started | Examples | Customize | Features | Install | Pricing
iPhoneNumberField("Phone", text: $text)
Install iPhoneNumberField
.
Add iPhoneNumberField
to your project.
import SwiftUI
import iPhoneNumberField
struct ContentView: View {
@State var text = ""
var body: some View {
iPhoneNumberField("Phone", text: $text)
}
}
iPhoneNumberField
Show the flag, and make it selectable, so your users can find their region.
import SwiftUI
import iPhoneNumberField
struct ContentView: View {
@State var text = ""
var body: some View {
iPhoneNumberField(text: $text)
.flagHidden(false)
.flagSelectable(true)
.font(UIFont(size: 30, weight: .bold, design: .rounded))
.padding()
}
}
Use iPhoneNumberField's optional binding and programmatically change the text field.
import SwiftUI
import iTextField
import iPhoneNumberField
struct ContentView: View {
@State var nameText = ""
@State var phoneText = ""
@State var phoneEditing = false
var body: some View {
VStack {
TextField("Name", text: $nameText)
.padding()
iPhoneNumberField("Phone", text: $phoneText, isEditing: $phoneEditing)
.font(UIFont(size: 24, weight: .light, design: .monospaced))
.padding()
}
}
}
Use our modifiers to create a fully customized field.
import SwiftUI
import iPhoneNumberField
struct ContentView: View {
@State var text: String = ""
@State var isEditing: Bool = false
var body: some View {
iPhoneNumberField("(000) 000-0000", text: $text, isEditing: $isEditing)
.flagHidden(false)
.flagSelectable(true)
.font(UIFont(size: 30, weight: .light, design: .monospaced))
.maximumDigits(10)
.foregroundColor(Color.pink)
.clearButtonMode(.whileEditing)
.onClear { _ in isEditing.toggle() }
.accentColor(Color.orange)
.padding()
.background(Color.white)
.cornerRadius(10)
.shadow(color: isEditing ? .lightGray : .white, radius: 10)
.padding()
}
}
iPhoneNumberField
takes 2 required parameters: 1๏ธโฃ a String
placeholder, and 2๏ธโฃ a binding to a phone number string. All customizations are built into our modifiers.
Example: Customize the text field style, and call a closure when editing ends.
iPhoneNumberField("", text: $text)
.accentColor(Color.green)
.clearsOnBeginEditing(true)
.clearButtonMode(.always)
.onEditingEnded { print("DONE โ
") }
Use our exhaustive input list to customize your view.
Modifier | Description | |
---|---|---|
๐ | .font(_:) |
Modifies the text fieldโs font from a UIFont object. |
๐จ | .foregroundColor(_:) |
Modifies the text color of the text field. |
๐ | .accentColor(_:) |
Modifies the cursor color while typing on the text field. |
๐ | .placeholderColor(_:) |
Modifies the entire placeholder color of the text field. |
๐ | .numberPlaceholderColor(_:) |
Modifies solely the phone number placeholder color of the text field โ without the country code. |
๐ | .countryCodePlaceholderColor(_:) |
Modifies solely the country code placeholder color of the text field โ without the phone number. |
โ๏ธ | .multilineTextAlignment(_:) |
Modifies the text alignment of a text field. |
โ๏ธ | .textContentType(_:) |
Modifies the content type of a text field for implied formatting. |
โถ๏ธ | .clearsOnEditingBegan(_:) |
Modifies the clear-on-begin-editing setting of a text field. |
๐ | .clearsOnInsert(_:) |
Modifies the clear-on-insertion setting of a text field. |
โ | .clearButtonMode(_:) |
Modifies whether and when the text field clear button appears on the view. |
โ๏ธ | .textFieldStyle(_:) |
Modifies the style of the text field to one of Appleโs three pre-designed styles. |
๐ | .maximumDigits(_:) |
Modifies the maximum number of digits the text field allows. |
๐ฆ๐ถ | .flagHidden(_:) |
Modifies whether the text field hides the country flag on the left ๐ธ๐ช๐น๐ผ๐จ๐ฌ. |
๐ธ๐ฎ | .flagSelectable(_:) |
Modifies whether the flag is selectable. |
โ | .prefixHidden(_:) |
Modifies whether the country code prefix should be hidden. Note: prefix will only be shown if using the default placeholder (placeholder = nil ). |
๐ | .formatted(_:) |
Modifies whether the binding you pass as the text parameter gets formatted. |
โ | .disabled(_:) |
Modifies whether the text field is disabled. |
โถ๏ธ | .onEditingBegan(perform: { code }) |
Modifies the function called when text editing begins. |
๐ฌ | .onNumberChange(perform: { code }) |
Modifies the function called when the user makes any changes to the text in the text field. |
๐ฌ | .onEdit(perform: { code }) |
Modifies the function called when the user makes any changes to the text in the text field. |
๐ | .onEditingEnded(perform: ({ code }) |
Modifies the function called when text editing ends. |
๐ | .onClear(perform: { code }) |
Modifies the function called when the user clears the text field. |
โช๏ธ | .onReturn(perfom: { code }) |
Modifies the function called when the user presses return. |
๐ณ๏ธ | .defaultRegion(_:) |
Receives a country string and selects the default phone format. |
Features | |
---|---|
โ๏ธ | Validate, normalize and extract the elements of any phone number string. |
๐ | Fast. 1000 parses -> ~0.4 seconds. |
๐ | Best-in-class metadata from Googleโs libPhoneNumber project. |
๐ | Fully tested to match the accuracy of Googleโs JavaScript implementation of libPhoneNumber. |
๐ฑ | Built for iOS. Automatically grabs the default region code from the phone. |
๐ | Editable (!) AsYouType formatter for UITextField. |
๐บ๐ธ | Convert country codes to country names and vice versa |
โ๏ธ | Access to all native UITextField configurations |
๐ | Searchable and customizable country code and name list |
โ | Many more features to discover |
You can use the Swift package manager to install iPhoneNumberField
. Find Xcode SPM instructions here
dependencies: [
.package(url: "https://github.com/MojtabaHs/iPhoneNumberField.git", .upToNextMinor(from: "0.10.0"))
]
This library is under the MIT license and completely FREE. Anyone can use it anywhere, and any contribution is welcome.
In addition, you can show your support and become My sponsor.
By supporting me, you will gainยน:
Remember that it is my pleasure to be a part of the community and try my best to deliver my experience to anyone who needs it.
ยน Paid program options are related to the chosen level.