public class PhoneNumberField

A phone number entry field: a country selector holding the calling code and a field for the rest of the number, producing one E.164 string.

Example

PhoneNumberField phone = new PhoneNumberField();
form.add(phone);
sendButton.addActionListener(e -> requestCode(phone.getE164()));

The selector starts on the country the device is in and opens a searchable list of every calling code. The number field carries TextArea#PHONENUMBER, so it gets the phone keypad and the platform offers the device’s own number where it knows it.

The value

#getE164() returns the number in the one format a server can act on – a leading “+”, the calling code, then the national number, digits only:

Everything that is not a digit is dropped, so the separators a user reaches for make no difference:

phone.setCountry(PhoneNumberField.findCountry("IL"));
// user types 50-123-4567, or 50 123 4567, or (50) 1234567
phone.getE164(); // "+972501234567"

A number that already carries its own calling code is used as it stands, and the selector is not applied to it. Pasting is one way that happens; platform autofill is the other, since it offers the device’s own number in exactly that form:

// Israel selected, the user pastes +1 415 555 0100
phone.getE164(); // "+14155550100", not the selection with that appended

A national trunk prefix is a digit, and it is kept:

// the same user typing the number the way they say it out loud
// user types 050-123-4567
phone.getE164(); // "+9720501234567" -- the leading 0 is still there

That is not an oversight, and it is the one thing to handle before sending. “0” is a trunk prefix in Israel and part of the number in Italy, and telling them apart is a per-country rule this field does not carry, so stripping one here would corrupt numbers in the countries where it belongs. Normalizing is left to the service that sends the message, which has the rules and can refuse what it cannot make sense of.

What this field does carry is the shape of E.164 – at most fifteen digits, and the calling code separated from the rest – so #isValid() is a sanity check rather than a verdict.

Country names

Names are English, and each is looked up first as “Country.” plus the ISO code in the theme’s resource bundle, so an application that ships translations gets them without replacing the list. An application with its own list entirely passes it to #setCountries(Country[]).

Styling

The field uses the UIID “PhoneNumberField”, the country selector “PhoneNumberCountry” and the number field “PhoneNumberText”.