Telephone International Widget

A field widget for entering and validating international telephone numbers.

This module provides an additional field widget to core's Telephone field type.

It utilizes a popular Javascript plugin for entering and validating international telephone numbers. The Javascript plugin uses a custom build of Google's libphonenumber library for validation, and supports the many different national number formats. (We suggest using E164 format).

Requirements

In addition to core modules, this module has one external Composer dependency: jackocnr/intl-tel-input.

Follow README to learn more about how to download this module and its dependencies with Composer. Note: This module expects that intl-tel-input is available via the Libraries API.

Suggestions

Works well alongside backend validation via telephone_validation and field display via telephone_formatter.

Roadmap

Currently, this module assumes default intl-tel-input settings, plus client-side validation and provides the utilsScript path. Upon passing client-side validation, this module will auto format the entered value. Eventually, this module could provide field settings options to match the available options from the intl-tel-input Javascript plugin.

Alternatives

International Phone Field provides a new field type using this same Javascript plugin.
This module diverged from International Phone Field by targeting the core Telephone field type, and by including the Javascript plugin through Composer, explicitly listing it as a drupal-library.

Attributions

Uses the jackocnr/intl-tel-input Javascript library.
Inspired by both the telephone_validation and telephone_formatter modules.
Inspired by Webform's use of composer libraries to get the required package to be of type drupal-library.