React-Phone-Input-International

Highly customizable phone input component with auto formatting.


!animation

Installation

``shell-script
npm install react-phone-input-international --save
`

Usage

`jsx
import PhoneInput from 'react-phone-input-international'
import 'react-phone-input-international/lib/style.css'

country={'us'}
value={this.state.phone}
onChange={phone => this.setState({ phone })}
/>
`
available styles - style • high-res • material • bootstrap • semantic-ui • plain

Options

Name	Type	Description	Example
country	string	initial country	'us' | 1
value	string	input state value
onlyCountries	array	country codes to be included	['cu','cw','kz']
preferredCountries	array	country codes to be at the top	['cu','cw','kz']
excludeCountries	array	array of country codes to be excluded	['cu','cw','kz']
placeholder	string	custom placeholder
inputProps	object	props to pass into the input

Booleans	Default	Description
autoFormat	true	on/off phone formatting
disabled	false	disable input and dropdown
disableDropdown	false	disable dropdown only
disableCountryCode	false
enableAreaCodes	false	enable local codes for all countries
enableTerritories	false	enable dependent territories with population of ~100,000 or lower
enableLongNumbers	false	boolean/number
countryCodeEditable	true
enableSearch	false	enable search in the dropdown
disableSearchIcon	false	hide icon for the search field

`jsx
inputProps={{
name: 'phone',
required: true,
autoFocus: true
}}
/>
`

$3

- Style
- Events
- Regions
- Localization
- Local area codes
- Custom masks
- Custom area codes
- Other props
- Custom localization
- Guides
- Phone without dialCode
- Check validity of the phone number
- CDN
- Contributing
- Support

$3

containerClass	string	class for container
inputClass	string	class for input
buttonClass	string	class for dropdown button
dropdownClass	string	class for dropdown container
searchClass	string	class for search field
containerStyle	object	styles for container
inputStyle	object	styles for input
buttonStyle	object	styles for dropdown button
dropdownStyle	object	styles for dropdown container
searchStyle	object	styles for search field

$3

onChange

onFocus

onBlur

onClick

onKeyDown

onChange(value, country, e, formattedValue)

Country data object not returns from onKeyDown event

Data	Type	Description
value/event	string/object	event or the phone number
country data	object	country object { name, dialCode, countryCode (iso2) }

$3

Name	Type	Description
regions	array/string	to show countries only from specified regions

Regions
['america', 'europe', 'asia', 'oceania', 'africa']
Subregions
['north-america', 'south-america', 'central-america', 'carribean', 'eu-union', 'ex-ussr', 'ex-yugos', 'baltic', 'middle-east', 'north-africa']

`jsx
country='de'
regions={'europe'}
/>

country='us'
regions={['north-america', 'carribean']}
/>
`

$3


es Spanish, de Deutsch, ru Russian, fr French

jp Japanese, cn Chinese, pt Portuguese, it Italian

ir Iranian, ar Arabic, tr Turkish, id Indonesian

`jsx
import es from 'react-phone-input-international/lang/es.json'

localization={es}
/>
`

$3


`jsx
enableAreaCodes={true}
enableAreaCodes={['us', 'ca']}
enableAreaCodeStretch
/>
`

#### Flexible mask
If enableAreaCodeStretch is added, the part of the mask with the area code will not stretch to length of the respective section of phone mask.
Example: +61 (2), +61 (02)

$3


`jsx
onlyCountries={['fr', 'at']}
masks={{fr: '(...) ..-..-..', at: '(....) ...-....'}}
/>
`

$3

`jsx
onlyCountries={['gr', 'fr', 'us']}
areaCodes={{gr: ['2694', '2647'], fr: ['369', '463'], us: ['300']}}
/>
`

$3

defaultMask	... ... ... ... ..
alwaysDefaultMask	false
prefix	+
searchPlaceholder	'search'
searchNotFound	'No entries to show'
copyNumbersOnly	true
renderStringAsFlag	string
autocompleteSearch	false
jumpCursorToEnd	false
priority	{{ca: 0, us: 1, kz: 0, ru: 1}}
enableClickOutside	true
showDropdown	false
defaultErrorMessage	string
specialLabel	string
disableInitialCountryGuess	false
disableCountryGuess	false

$3

`jsx
onlyCountries={['de', 'es']}
localization={{de: 'Deutschland', es: 'España'}}
/>

onlyCountries={['de', 'es']}
localization={{'Germany': 'Deutschland', 'Spain': 'España'}}
/>
`

$3


`jsx
onlyCountries={['fr', 'at']}
preserveOrder={['onlyCountries', 'preferredCountries']}
/>
`

Guides

$3

`jsx
handleOnChange(value, data, event, formattedValue) {
this.setState({ rawPhone: value.slice(data.dialCode.length) })
}
`

$3

isValid(value, country, countries, hiddenAreaCodes)

`jsx
isValid={(value, country) => {
if (value.match(/12345/)) {
return 'Invalid value: '+value+', '+country.name;
} else if (value.match(/1234/)) {
return false;
} else {
return true;
}
}}
/>
`

`jsx
import startsWith from 'lodash.startswith';

isValid={(inputNumber, country, countries) => {
return countries.some((country) => {
return startsWith(inputNumber, country.dialCode) || startsWith(country.dialCode, inputNumber);
});
}}
/>
`

$3


To clear country, pass null as value.

$3

`html

``

Contributing

- Code style changes not allowed
- Do not create issues about incorrect or missing country masks (of already present countries) or absent area codes (they will be closed). Only create issues if the subject is an actual mechanism that is not present in the component. Otherwise create a PR with a link that proves the correctness of your newly suggested mask or list of area codes
- Do not send new languages

License


Based on react-phone-input-2