@diogoccoutinho/vue-international-phone

0.0.33 • Public • Published

📞 Vue International Phone Input Component 📞

npm version GitHub version License: MIT Issues Stars Forks Github Package Registry Downloads Maintained Last commit Contributors Size Languages Top language Code size Code Pen LinkedIn Twitter GitHub followers

This is a Vue.js component that provides an international phone input with a country selector and mask.

Funcionando 100%

Getting Started

Installation

You can install the component via Yarn:

yarn add @diogoccoutinho/vue-international-phone

You can install the component via npm:

npm install @diogoccoutinho/vue-international-phone
Register the component

Global Registration

import Vue from 'vue'
import VueInputPhone from '@diogoccoutinho/vue-international-phone'
import '@diogoccoutinho/vue-international-phone/dist/VueInternationalPhone.css'

Vue.use(VueInputPhone)

new Vue({
  // ...
}).$mount('#app')

Local Registration

import VueInputPhone from '@diogoccoutinho/vue-international-phone'
import '@diogoccoutinho/vue-international-phone/dist/VueInternationalPhone.css'

export default {
  // ...
  components: {
    VueInputPhone
  }
}

Usage

To use the Vue International Phone Input Component, import and register it in your Vue application:

<VueInputPhone
    :selectedItem="selectedCountry"
    :phoneNumber="phoneNumber"
    :placeholder="placeholder"
    :custom-class="customClass"
    @update:selectedItem="updateSelectedItem"
    @update:phoneNumber="updatePhoneNumber"
/>

Props

  • selectedItem: Object defining the selected country (optional).
{
      "code": "55",
      "name": "Brazil",
      "flag": "br",
      "COUNTRY_CODE": "BR",
      "mask": "(##) #####-####",
      "emoji": "🇧🇷"
}
  • phoneNumber: The default phone number.
  • placeholder: Placeholder text for the phone number input. Default: "Phone Number" (optional).
  • customClass: Custom class to style the component. It replaces the default class (optional).
  • openIcon: Icon to open the country selector. Default: "▾" (optional).
  • closeIcon: Icon to close the country selector. Default: "▴" (optional).
  • showFlag: Boolean to control the visibility of the flags in the country selector. Default: true (optional).
  • showCountryCode: Boolean to control the visibility of the country code in the country selector. Default: true (optional).
  • showCode: Boolean to control the visibility of the country code in the phone number input. Default: true (optional).
  • inputIconClass: Custom class to style the input icon. Default: "" (optional).

Events

  • update:selectedItem: Emitted when the selected country is changed.
  • update:phoneNumber: Emitted when the phone number is changed.

Examples

You can customize the appearance of the component by passing the customClass prop:

<template>
  <div>
    <VueInputPhone
        :selectedItem="selectedCountry"
        :phoneNumber="phoneNumber"
        :placeholder="placeholder"
        :custom-class="customClass"
        @update:selectedItem="updateSelectedItem"
        @update:phoneNumber="updatePhoneNumber"
    />
  </div>
</template>

<script>
  import VueInputPhone from '@diogoccoutinho/vue-international-phone';
  import '@diogoccoutinho/vue-international-phone/dist/vueInternationalPhone.css';
  export default {
    components: {
      VueInputPhone,
    },
    data() {
      return {
        selectedCountry: {},
        phoneNumber: "", // Phone Number
        placeholder: "Phone Number",
        customClass: "my-custom-phone-input",
      };
    },
    methods: {
      updateSelectedItem(item) {
        this.selectedCountry = item;
      },
      updatePhoneNumber(phoneNumber) {
        this.phoneNumber = phoneNumber;
      },
    },
  };
</script>

<style>
  .my-custom-phone-input {
    /* Your custom styles here */
  }
</style>

Notes

Be sure to add the provided CSS styles in the component to achieve the desired layout.

Contribution

Contributions are welcome! Feel free to submit pull requests or report issues.

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by Diogo Coutinho

Package Sidebar

Install

npm i @diogoccoutinho/vue-international-phone

Weekly Downloads

21

Version

0.0.33

License

MIT

Unpacked Size

142 kB

Total Files

10

Last publish

Collaborators

  • diogoccoutinho