vue-tel-input

International Telephone Input with Vue.

Documentation and Demo

Visit the website

Vue 2 Support

vue-tel-input@legacy: Guide

Changelog

Go to Github Releases

Getting started

• Install the plugin:

  1npm install vue-tel-input

• Add the plugin into your app:

  1import Vue from 'vue';
  2import VueTelInput from 'vue-tel-input';
  3import 'vue-tel-input/vue-tel-input.css';
  4
  5const app = createApp(App);
  6app.use(VueTelInput);
  7app.mount('#app');

  More info on installation

• Use the vue-tel-input component:

  1<template>
  2  <vue-tel-input v-model="phone"></vue-tel-input>
  3</template>

Installation

npm

1  npm install vue-tel-input

Install the plugin into Vue:

1import { createApp } from 'vue';
2import App from './App.vue';
3import VueTelInput from 'vue-tel-input';
4import 'vue-tel-input/vue-tel-input.css';
5
6const globalOptions = {
7  mode: 'auto',
8};
9
10const app = createApp(App);
11app.use(VueTelInput, globalOptions); // Define default global options here (optional)
12app.mount('#app');

View all available options in Props.

Or use the component directly:

1<template>
2  <vue-tel-input v-model="phone" mode="international"></vue-tel-input>
3</template>
4
5<script>
6  import { ref } from 'vue';
7  import { VueTelInput } from 'vue-tel-input';
8  import 'vue-tel-input/vue-tel-input.css';
9
10  export default {
11    components: {
12      VueTelInput,
13    },
14
15    setup() {
16      const phone = ref(null);
17
18      return {
19        value,
20      };
21    },
22  };
23</script>

Browser

1<script src="https://unpkg.com/vue-tel-input"></script>
2<link rel="stylesheet" href="https://unpkg.com/vue-tel-input/dist/vue-tel-input.css" />

If Vue is detected in the Page, the plugin is installed automatically.

** Otherwise, manually install the plugin into Vue:

1app.use(window['vue-tel-input']);

Component lazy loading

Since the library is about 200kb of JavaScript and 100kb of CSS in order to improve initial page loading time you might consider importing it asynchronously only when user navigates to the page where the library is actually needed. The technique is called Lazy Load and you can use it in some modern bundlers like Webpack and Rollup.

1<!-- your-component.vue-->
2<template>
3  <vue-tel-input v-model="value"></vue-tel-input>
4</template>
5<script>
6  const VueTelInput = () =>
7    Promise.all([
8      import(/* webpackChunkName: "chunk-vue-tel-input" */ 'vue-tel-input'),
9      import(/* webpackChunkName: "chunk-vue-tel-input" */ 'vue-tel-input/vue-tel-input.css'),
10    ]).then(([{ VueTelInput }]) => VueTelInput);
11
12  export default {
13    components: {
14      VueTelInput,
15    },
16  };
17</script>

As you see, we don't use Vue SFC <style></style> tag here to import component's css as it would result in CSS going to the main/vendors bundle instead of being downloaded on demand.

Development

Clone the project

1  git clone https://github.com/iamstevendao/vue-tel-input.git

Go to the project directory

1  cd vue-tel-input

Install dependencies

1  npm install

Start the server

1  npm run dev

License

Copyright (c) 2018 Steven Dao. Released under the MIT License.

made with ❤ by Steven.