react-international-phone

react-international-phone

🤙 International phone input component for React

Live demo: Storybook

Features

• 😎 Easy to integrate - Just import and use, no need for the initial setup.
• 🔍 Country guessing - Just start typing and the component will guess the country.
• 🏳️ Country flags - Country flags are rendered using Twemoji.
• ⌨ Caret position handling - Typing in the middle of the input, selection and deletion feels naturally.
• ✨ Lightweight - Low bundle size, no third-party dependencies.
• 🌈 Easy to customize - Customize styles and component behavior using props.

Installation

$ npm i react-international-phone

Basic usage

import { useState } from 'react';
import { PhoneInput } from 'react-international-phone';
import 'react-international-phone/style.css';

const App = () => {
  const [phone, setPhone] = useState('');

  return (
    <div>
      <PhoneInput
        initialCountry="ua"
        value={phone}
        onChange={(phone) => setPhone(phone)}
      />
    </div>
  );
};

Documentation

Find the full API reference on official documentation.

Changelog

v1.5.1 (2022-12-11)

• Fix dropdown closing, update docs #11
• Update issue templates #10
• imp(docs): add code of conduct d149bb5
• fix(country-selector): close dropdown on click while dropdown is open 16c49eb
• imp(docs): add contributing doc 4484cda