International Telephone Input

A jQuery plugin for entering international telephone numbers. It adds a flag dropdown to any input, which lists all the countries and their international dial codes next to their flags.

Demo

http://jackocnr.com/intl-tel-input.html
Try it for yourself using the included demo.html

Features

• In the country dropdown you can navigate by typing, or using the up/down keys
• Selecting a country from the dropdown will update the dial code in the input
• Typing a different dial code automatically updates the displayed flag
• Country names in the dropdown also include localised versions in brackets
• Lots of initialisation options for customisation, as well as public methods for interaction

Getting started

1. Download the latest version, or better yet install it with Bower: bower install intl-tel-input
2. Link the stylesheet (note that this references the image flags.png)

<link rel="stylesheet" href="build/css/intlTelInput.css">

3. Add the plugin script and initialise it on your input element (alternatively, use a script loader like RequireJS)

<input type="tel" id="mobile-number">

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
<script src="build/js/intlTelInput.min.js"></script>
<script>
  $("#mobile-number").intlTelInput();
</script>

Options

Note: any options that take country codes should be lower case ISO 3166-1 alpha-2 codes

americaMode
Type: Boolean Default: false
Don't display the +1 prefix for American numbers, because a lot of Americans are unfamiliar with international dial codes.

autoHideDialCode
Type: Boolean Default: true
If there is just a dial code in the input: remove it on blur, and re-add it on focus. This is to prevent just a dial code getting submitted with the form.

defaultCountry
Type: String Default: ""
Set the default country by it's country code. Otherwise it will just be the first country in the list.

dialCodeDelimiter
Type: String Default: " "
Choose the delimiter that is inserted after the dial code when the user selects a country from the dropdown.

defaultStyling
Type: Boolean Default: "inside"
If you would like the default minimal styling, there are two options to choose from which specify the position of the selected flag: "inside" or "outside" (relative to the input). You can also disable all styling by choosing "none".

onlyCountries
Type: Array Default: undefined
Display only the countries you specify.

preferredCountries
Type: Array Default: ["us", "gb"]
Specify the countries to appear at the top of the list.

validationScript
Type: String Default: "" Example: "lib/libphonenumber/build/isValidNumber.js"
Enable validation by specifying the URL to the included libphonenumber script. When the plugin is initialised, it will add a <script> element to the end of the body to load this ~200kb script, which is then accessible through the public isValidNumber function.

Public methods

getSelectedCountryData
Get the country data for the currently selected flag

$("#mobile-number").intlTelInput("getSelectedCountryData");

isValidNumber
Validate the current number using Google's libphonenumber (requires the validationScript option to be set correctly)

$("#mobile-number").intlTelInput("isValidNumber");

selectCountry
Select a country after initialisation (e.g. when the user is entering their address)

$("#mobile-number").intlTelInput("selectCountry", "gb");

setNumber
Insert a number, and update the selected flag accordingly

$("#mobile-number").intlTelInput("setNumber", "+44 77333 123 456");

Static methods

getCountryData
Get all of the plugin's country data

var countryData = $.fn.intlTelInput.getCountryData();

setCountryData
Set all of the plugin's country data

$.fn.intlTelInput.setCountryData(countryData);

Validation

International number validation is hard (it varies by country/district). The only comprehensive solution I have found is Google's libphonenumber, which I have precompiled into a single JavaScript file and included in the lib directory. Unfortunately even after minification it is still ~200kb, so I have included it as an optional extra. If you specify the validationScript option then when the plugin is initialised it will add a <script> element to the end of the body to load the script, which is then accessible through the public isValidNumber function.

CSS

Image path
Depending on your project setup, you may need to override the path to flags.png in your CSS.

.intl-tel-input .flag {background-image: url("path/to/flags.png");}

Input margin
For the sake of alignment, the default CSS forces the input's vertical margin to 0px. If you want vertical margin, you should add it to the container (with class intl-tel-input).

Attributions

• Flag images and CSS from https://github.com/tkrotoff/famfamfam_flags
• Country data from https://github.com/mledoze/countries
• Validation code from http://libphonenumber.googlecode.com