implement
Phone Input

Phone Input

A phone number field with a searchable country picker.

Enter a phone number.
import { Div, signal, Span } from "@implementjs/core";
import { PhoneInput, type CountryCode } from "@/lib/components/ui/phone-input";

export default function PhoneInputDemo() {
	const value = signal("");
	const country = signal<CountryCode | null>("US");

	return Div(
		{ class: "flex w-full max-w-sm flex-col gap-2" },
		PhoneInput({ value, country, placeholder: "Enter a phone number" }),
		Span(
			{ class: "text-sm text-muted-foreground" },
			value.bind((v) => (v === "" ? "Enter a phone number." : `E.164: ${v}`)),
		),
	);
}

Installation

npx jsrepo add @implementjs/ui/phone-input

It installs @implementjs/lucide and country-flag-icons at the same time, plus the popover and command components it is built from.

Usage

import { signal } from "@implementjs/core";
import { PhoneInput, type CountryCode } from "@/lib/components/ui/phone-input";

const country = signal<CountryCode | null>("US");
const value = signal("");

PhoneInput({ country, value, placeholder: "Enter a phone number" });

value is the number in E.164 form. Typing a number that starts with + picks its country for you.

Countries

Offer fewer countries, or in your own order, by passing countries:

import { getPhoneCountries } from "@/lib/components/ui/phone-input";

const all = getPhoneCountries();
const first = ["US", "CA", "GB"];
const countries = [
	...all.filter((c) => first.includes(c.code)),
	...all.filter((c) => !first.includes(c.code)),
];

PhoneInput({ countries });

Invalid

Pass aria-invalid to the number field and it takes the destructive border:

PhoneInput({ inputProps: { "aria-invalid": true } });

API Reference

Every prop the styling does not consume is forwarded to the Phone Input primitive, so the tables below are the whole surface.

PhoneInput

A phone input, fully assembled: a searchable country picker beside the number field. Every root prop below is forwarded. Renders a Div; extra props are forwarded onto it.

PropTypeDefaultDescription
placeholderstring—Placeholder for the number field.
inputPropsElementProps<"input">—Props for the number field — an aria-label, aria-invalid, or an event handler.
countriesPhoneCountry[]—The countries to offer, in the order to show them. Defaults to getPhoneCountries(), every country sorted by name.
countrySignal<CountryCode | null> | CountryCode | nullnullThe selected country, as an ISO 3166-1 alpha-2 code. Pass a signal to control it from outside. Typing a number that starts with + sets it.
onCountryChange(country: CountryCode | null) => void—Runs whenever the country changes.
valueSignal<string> | string""The number in E.164 form, like "+15551234567". Pass a signal to control it from outside.
onValueChange(value: string) => void—Runs whenever the number changes.
validSignal<boolean>—Receives whether the number is complete and valid for its country. An empty field counts as valid.
disabledReadable<boolean> | booleanfalseDisables the field.
readOnlybooleanfalseMakes the field read-only.
namestring—Submits the E.164 number with a form under this name.
Data attributeValue
[data-phone-input-root]Present
[data-disabled]Present when disabled
[data-valid]"false" when the number is not valid
Country
Afghanistan+93
Åland Islands+358
Albania+355
Algeria+213
American Samoa+1
Andorra+376
Angola+244
Anguilla+1
Antigua & Barbuda+1
Argentina+54
Armenia+374
Aruba+297
Ascension Island+247
Australia+61
Austria+43
Azerbaijan+994
Bahamas+1
Bahrain+973
Bangladesh+880
Barbados+1
Belarus+375
Belgium+32
Belize+501
Benin+229
Bermuda+1
Bhutan+975
Bolivia+591
Bosnia & Herzegovina+387
Botswana+267
Brazil+55
British Indian Ocean Territory+246
British Virgin Islands+1
Brunei+673
Bulgaria+359
Burkina Faso+226
Burundi+257
Cambodia+855
Cameroon+237
Canada+1
Cape Verde+238
Caribbean Netherlands+599
Cayman Islands+1
Central African Republic+236
Chad+235
Chile+56
China+86
Christmas Island+61
Cocos (Keeling) Islands+61
Colombia+57
Comoros+269
Congo - Brazzaville+242
Congo - Kinshasa+243
Cook Islands+682
Costa Rica+506
Côte d’Ivoire+225
Croatia+385
Cuba+53
Curaçao+599
Cyprus+357
Czechia+420
Denmark+45
Djibouti+253
Dominica+1
Dominican Republic+1
Ecuador+593
Egypt+20
El Salvador+503
Equatorial Guinea+240
Eritrea+291
Estonia+372
Eswatini+268
Ethiopia+251
Falkland Islands+500
Faroe Islands+298
Fiji+679
Finland+358
France+33
French Guiana+594
French Polynesia+689
Gabon+241
Gambia+220
Georgia+995
Germany+49
Ghana+233
Gibraltar+350
Greece+30
Greenland+299
Grenada+1
Guadeloupe+590
Guam+1
Guatemala+502
Guernsey+44
Guinea+224
Guinea-Bissau+245
Guyana+592
Haiti+509
Honduras+504
Hong Kong SAR China+852
Hungary+36
Iceland+354
India+91
Indonesia+62
Iran+98
Iraq+964
Ireland+353
Isle of Man+44
Israel+972
Italy+39
Jamaica+1
Japan+81
Jersey+44
Jordan+962
Kazakhstan+7
Kenya+254
Kiribati+686
Kosovo+383
Kuwait+965
Kyrgyzstan+996
Laos+856
Latvia+371
Lebanon+961
Lesotho+266
Liberia+231
Libya+218
Liechtenstein+423
Lithuania+370
Luxembourg+352
Macao SAR China+853
Madagascar+261
Malawi+265
Malaysia+60
Maldives+960
Mali+223
Malta+356
Marshall Islands+692
Martinique+596
Mauritania+222
Mauritius+230
Mayotte+262
Mexico+52
Micronesia+691
Moldova+373
Monaco+377
Mongolia+976
Montenegro+382
Montserrat+1
Morocco+212
Mozambique+258
Myanmar (Burma)+95
Namibia+264
Nauru+674
Nepal+977
Netherlands+31
New Caledonia+687
New Zealand+64
Nicaragua+505
Niger+227
Nigeria+234
Niue+683
Norfolk Island+672
North Korea+850
North Macedonia+389
Northern Mariana Islands+1
Norway+47
Oman+968
Pakistan+92
Palau+680
Palestinian Territories+970
Panama+507
Papua New Guinea+675
Paraguay+595
Peru+51
Philippines+63
Poland+48
Portugal+351
Puerto Rico+1
Qatar+974
Réunion+262
Romania+40
Russia+7
Rwanda+250
Samoa+685
San Marino+378
São Tomé & Príncipe+239
Saudi Arabia+966
Senegal+221
Serbia+381
Seychelles+248
Sierra Leone+232
Singapore+65
Sint Maarten+1
Slovakia+421
Slovenia+386
Solomon Islands+677
Somalia+252
South Africa+27
South Korea+82
South Sudan+211
Spain+34
Sri Lanka+94
St. Barthélemy+590
St. Helena+290
St. Kitts & Nevis+1
St. Lucia+1
St. Martin+590
St. Pierre & Miquelon+508
St. Vincent & Grenadines+1
Sudan+249
Suriname+597
Svalbard & Jan Mayen+47
Sweden+46
Switzerland+41
Syria+963
Taiwan+886
Tajikistan+992
Tanzania+255
Thailand+66
Timor-Leste+670
Togo+228
Tokelau+690
Tonga+676
Trinidad & Tobago+1
Tristan da Cunha+290
Tunisia+216
Türkiye+90
Turkmenistan+993
Turks & Caicos Islands+1
Tuvalu+688
U.S. Virgin Islands+1
Uganda+256
Ukraine+380
United Arab Emirates+971
United Kingdom+44
United States+1
Uruguay+598
Uzbekistan+998
Vanuatu+678
Vatican City+39
Venezuela+58
Vietnam+84
Wallis & Futuna+681
Western Sahara+212
Yemen+967
Zambia+260
Zimbabwe+263