vue-tel-input - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #llm #golang #go #macos #windows #awesome #awesome-list #pytorch #mcp #ios

vue-tel-input

(★ 898)

International Telephone Input with Vue

File Explorer

Download Latest Version (.zip)

- - deploy.yml
- FUNDING.yml
- settings.json
- - config.ts
- - getting-started.md
  - installation.md
  - legacy.md
- - credits.md
  - typescript-support.md
  - v2.md
  - v3.md
- - favicon-16x16.png
  - favicon-32x32.png
  - hero.png
- - custom-form-of-vue-form-generator.md
  - events.md
  - props.md
  - slots.md
- index.md
- - all-countries.ts
  - component.css
  - sprite.css
- - vue-tel-input.test.ts
  - vue-tel-input.vue
- - click-outside.js
- - index.d.ts
- index.js
- phone-parser.ts
- utils.ts
.browserslistrc
.editorconfig
.eslintrc.cjs
.gitignore
env.d.ts
LICENSE
package-lock.json
package.json
README.md
tsconfig.json
tsconfig.node.json
vite.config.ts

# Installation Guide

1. Get the code

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

Downloads the entire project code from GitHub to your computer.

cd vue-tel-input

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install vue-tel-input

Downloads and installs the libraries listed in package.json.

npm install

Downloads and installs the libraries listed in package.json.

npm run dev

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
<img width="100" alt="vue-tel-input-logo" src="https://iamstevendao.com/vue-tel-input/hero.png"/>
</p>

# vue-tel-input

International Telephone Input with Vue.

[![npm](https://img.shields.io/npm/dt/vue-tel-input.svg)](https://www.npmjs.com/package/vue-tel-input) [![stars](https://img.shields.io/github/stars/iamstevendao/vue-tel-input.svg)](https://github.com/iamstevendao/vue-tel-input)

<p align="center">
<img width="600" alt="In-action GIF" src="https://thumbs.gfycat.com/EducatedPoliteBluefintuna-size_restricted.gif"/>
</p>

## Documentation and Demo

[Visit the website](https://iamstevendao.com/vue-tel-input/)

## Vue 2 Support

`vue-tel-input@legacy`: [Guide](https://iamstevendao.com/vue-tel-input/guide/legacy.html)

## Changelog

[Go to Github Releases](https://github.com/iamstevendao/vue-tel-input/releases)

## Getting started

- Install the plugin:

```sh
  npm install vue-tel-input
  ```

- Add the plugin into your app:

```javascript
  import Vue from 'vue';
  import VueTelInput from 'vue-tel-input';
  import 'vue-tel-input/vue-tel-input.css';

const app = createApp(App);
  app.use(VueTelInput);
  app.mount('#app');
  ```

[More info on installation](#installation)

- Use the `vue-tel-input` component:

```html
  <template>
    <vue-tel-input v-model="phone"></vue-tel-input>
  </template>
  ```

## Installation

### npm

```bash
  npm install vue-tel-input
```

Install the plugin into Vue:

```javascript
import { createApp } from 'vue';
import App from './App.vue';
import VueTelInput from 'vue-tel-input';
import 'vue-tel-input/vue-tel-input.css';

const globalOptions = {
  mode: 'auto',
};

const app = createApp(App);
app.use(VueTelInput, globalOptions); // Define default global options here (optional)
app.mount('#app');
```

> View all available options in [Props](https://iamstevendao.com/vue-tel-input/usage/props.html).

Or use the component directly:

```html
<template>
  <vue-tel-input v-model="phone" mode="international"></vue-tel-input>
</template>

<script>
  import { ref } from 'vue';
  import { VueTelInput } from 'vue-tel-input';
  import 'vue-tel-input/vue-tel-input.css';

export default {
    components: {
      VueTelInput,
    },

setup() {
      const phone = ref(null);

return {
        value,
      };
    },
  };
</script>
```

### Browser

```html
<script src="https://unpkg.com/vue-tel-input"></script>
<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:

```js
app.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](https://webpack.js.org/guides/lazy-loading/) and you can use it in some modern bundlers like Webpack and Rollup.

```html

<template>
  <vue-tel-input v-model="value"></vue-tel-input>
</template>
<script>
  const VueTelInput = () =>
    Promise.all([
      import(/* webpackChunkName: "chunk-vue-tel-input" */ 'vue-tel-input'),
      import(/* webpackChunkName: "chunk-vue-tel-input" */ 'vue-tel-input/vue-tel-input.css'),
    ]).then(([{ VueTelInput }]) => VueTelInput);

export default {
    components: {
      VueTelInput,
    },
  };
</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

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

Go to the project directory

```bash
  cd vue-tel-input
```

Install dependencies

```bash
  npm install
```

Start the server

```bash
  npm run dev
```

## License

Copyright (c) 2018 Steven Dao.
Released under the [MIT License](https://github.com/iamstevendao/vue-tel-input/blob/master/LICENSE).

made with &#x2764; by [Steven](https://github.com/iamstevendao).