When to use it
Use for international phone entry that needs discoverable country selection and a validated E.164 result. Persist or dial e164 only when isValid is true.
FormsReact Native
Phone input
Enter an international phone number with searchable countries, calling codes, formatting, validation, and E.164 output.
Native example
Use Phone input
Use for international phone entry that needs discoverable country selection and a validated E.164 result. Persist or dial e164 only when isValid is true.
View verified React Native runtime capture
const colombia = getLumenPhoneCountry('CO', { locale: 'en-US' })
if (!colombia) throw new Error('Missing Colombia metadata')
const [phone, setPhone] = useState(() =>
createEmptyLumenPhoneNumber(colombia)
)
<LumenPhoneInput
label="Hospital or OB phone number"
value={phone}
onValueChange={setPhone}
/>Reference
Public API
The primary shared and platform-specific options exposed by LumenPhoneInput.
| API | Values or type | Default | Description |
|---|---|---|---|
| value / onValueChange | LumenPhoneNumber / callback | Required | Controls the country, editable national number, validity, and normalized E.164 result. |
| countries | Platform country collection | Generated metadata | Populates the searchable country picker. |
| locale | Platform locale | Current locale | Localizes generated country names and international paste resolution. |
| description / errorMessage | String? | null | Provides supporting text or an application-owned validation message. |
| invalidNumberMessage | String | Enter a complete phone number. | Localizes metadata-backed invalid-number feedback. |
| showValidationError | Boolean | true | Lets the application defer invalid-number feedback until its chosen interaction boundary. |
| enabled / required | Boolean | true / false | Controls native disabled and required presentation. |
Native behavior
Design and accessibility
Accessibility
The country selector announces the localized country name and calling code. Flags supplement visible text and are never the only country identifier.
Shared component