A beautiful text field to format phone numbers made with VueJS

A beautiful text field to format phone numbers made with VueJS

A beautiful text field to format phone numbers made with VueJS.


A beautiful text field to format phone numbers made with VueJS





Using yarn

yarn add vue-phone-number-input

Using npm

npm i --save vue-phone-number-input


ES6 Modules / CommonJS

import VuePhoneNumberInput from 'vue-phone-number-input';
import 'vue-phone-number-input/dist/vue-phone-number-input.css';

Vue.component('vue-phone-number-input', VuePhoneNumberInput);
<VuePhoneNumberInput v-model="yourValue" />


<VuePhoneNumberInput v-model="yourValue" />

<script src="https://unpkg.com/vue" charset="utf-8"></script>
<script src="./dist/vue-phone-number-input.umd.min.js" charset="utf-8"></script>
<link rel="stylesheet" type="text/css" href="./dist/vue-phone-number-input.css">

<script type="text/javascript">
  Vue.component('vue-phone-number-input', window.VuePhoneNumberInput.default);

Features List

  • You can set preferred-countries, ignored-countries or have only-countries
  • Validator State : input becomes green (you can modify this color with valid-color option) when the phone number is valid (can be disabled by no-validator-state attr)
  • Use browser locale to set the country calling code (can be disabled & you can use default-country-code option)
  • Phone number formatting while typing
  • You can search your country in list (open countries list & type your country name)
  • Keyboard accessibility (Arrow down, Arrow up : Countries list navigation - Escape : Close countries list)
  • Phone number example for each country in placeholder/label
  • Auto focus phone number input after selecting country
  • Differents size of input (sm or lg)
  • You can disable the flags - no-flags props
  • Dark UI option
  • Disabled option
  • Set your translations

Props API

Props Type Required Default
v-model String/Int true -
id String false VuePhoneNumberInput
color String HEX no dogderblue
valid-color String HEX no yellowgreen
size String sm|lg no null
default-country-code (1) String no null
preferred-countries (2) Array<string> no null
ignored-countries Array<string> no null
only-countries Array<string> no null
no-validator-state Boolean no false
no-use-browser-locale Boolean no false
no-flags Boolean no false
disabled Boolean no false
dark Boolean no false
required Boolean no false
error Boolean no false
translations (3) Object no null

(1) Ex : default-country-code="FR"

(2) Ex : preferred-countries="['FR', 'BE', 'DE']" This countries will be at the top of the list

(3) translations comes to replace default texts - Ex :

  countrySelectorLabel: 'Code pays',
  countrySelectorError: 'Choisir un pays',
  phoneNumberLabel: 'Numéro de téléphone',
  example: 'Exemple :'

Keyboard accessibility

Props Action
ArrowDown Navigation down in countries list
ArrowUp Navigation up in countries list
Escape Close countries list
All letters characters Searching country name in countries list (should be open)


Project setup

npm install

Compiles and hot-reloads for development

npm run serve

Lints and fixes files

npm run lint


This project is licensed under MIT License

Github Repository

Tags: #VueJs #Input