Gathering detailed insights and metrics for ngx-intl-tel-input
Gathering detailed insights and metrics for ngx-intl-tel-input
Gathering detailed insights and metrics for ngx-intl-tel-input
Gathering detailed insights and metrics for ngx-intl-tel-input
ngx-mat-input-tel
An Angular Material package for entering and validating international telephone numbers. It adds a flag dropdown to any input, detects the user's country, displays a relevant placeholder and provides formatting/validation methods.
@andela-dev/ngx-intl-tel-input
[](#contributors)
ngx-mat-intl-tel-input
An Angular Material package for entering and validating international telephone numbers. It adds a flag dropdown to any input, detects the user's country, displays a relevant placeholder and provides formatting/validation methods.
ngx-material-intl-tel-input
Angular Material international telephone input
Phone number input field to support international numbers, Angular
npm install ngx-intl-tel-input
Typescript
Module System
Node Version
NPM Version
Move angular support to 14
Updated on Nov 24, 2022
v3.x.x -> Angular 9.x.x - 10.x.x
Updated on Sep 06, 2020
v2.x.x -> Angular 8.x.x - 9.1.x
Updated on Sep 06, 2020
Fixes: Cannot read property 'querySelector' of undefined
Updated on Jun 19, 2020
ReadMe update to reflect Angular 9 support.
Updated on Jun 08, 2020
[id] name change and support for Angular 9
Updated on Jun 08, 2020
TypeScript (82.99%)
HTML (7.76%)
CSS (5.49%)
JavaScript (3.77%)
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
MIT License
222 Stars
452 Commits
344 Forks
12 Watchers
10 Branches
27 Contributors
Updated on Apr 25, 2025
Latest Version
17.0.0
Package Id
ngx-intl-tel-input@17.0.0
Unpacked Size
380.62 kB
Size
93.66 kB
File Count
41
NPM Version
10.7.0
Node Version
18.20.4
Published on
Feb 24, 2025
Cumulative downloads
Total Downloads
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
1
An Angular package for entering and validating international telephone numbers. It adds a flag dropdown to any input, detects the user's country, displays a relevant placeholder and provides formatting/validation methods.
Compatibility:
Validation with google-libphonenumber
ngx-intl-tel-input | Angular | ngx-bootstrap |
---|---|---|
17.x.x | >= 17.x.x | >= 12.0.0 |
16.x.x | >= 16.x.x | >= 11.0.0 |
15.x.x | >= 15.x.x | >= 10.0.0 |
14.x.x | 12.x.x - 14.x.x | >= 6.0.0 |
13.x.x | 12.x.x - 13.x.x | >= 6.0.0 |
3.2.1 | 12.x.x - 13.x.x | >= 6.0.0 |
3.1.3 | 8.x.x - 11.x.x | 6.0.x |
2.x.x | 8.x.x - 9.1.x | 5.6.x |
$ npm install intl-tel-input@19 --save
$ npm install google-libphonenumber --save
$ ng add ngx-bootstrap
If you do not wish to use Bootstrap's global CSS, we now package the project with only the relevant
bootstrap styling needed for the dropdown. As such, you can remove the bootstrap styling from angular.json
.
Further, Angular CLI should tree-shake the rest of Ngx-Boostrap away if you don't utilize other dependencies from the bootstrap package. This should keep this dependency a lean feature-add
Add 'intl-tel-input' style file:
./node_modules/intl-tel-input/build/css/intlTelInput.css
to angular.json styles array:
1 2"styles": [ 3 "./node_modules/intl-tel-input/build/css/intlTelInput.css", 4 "src/styles.css" 5], 6
$ npm install ngx-intl-tel-input --save
Add NgxIntlTelInputModule
to your module file:
1imports: [NgxIntlTelInputModule];
Refer to main app in this repository for working example.
Or this:
1<form #f="ngForm" [formGroup]="phoneForm"> 2 <ngx-intl-tel-input 3 [cssClass]="'custom'" 4 [preferredCountries]="[CountryISO.UnitedStates, CountryISO.UnitedKingdom]" 5 [enableAutoCountrySelect]="false" 6 [enablePlaceholder]="true" 7 [searchCountryFlag]="true" 8 [searchCountryField]="[SearchCountryField.Iso2, SearchCountryField.Name]" 9 [selectFirstCountry]="false" 10 [selectedCountryISO]="CountryISO.India" 11 [maxLength]="15" 12 [phoneValidation]="true" 13 [inputId]="my-input-id" 14 name="phone" 15 formControlName="phone" 16 ></ngx-intl-tel-input> 17</form>
Options | Type | Default | Description |
---|---|---|---|
cssClass | string | control-form | Bootstrap input css class or your own custom one. |
preferredCountries | <CountryISO>[] | [] | List of countries, which will appear at the top. |
onlyCountries | <CountryISO>[] | [] | List of manually selected countries, which will appear in the dropdown. |
enableAutoCountrySelect | boolean | true | Toggle automatic country (flag) selection based on user input. |
enablePlaceholder | boolean | true | Input placeholder text, which adapts to the country selected. |
customPlaceholder | string | None | Custom string to be inserted as a placeholder. |
numberFormat | <PhoneNumberFormat> | PhoneNumberFormat.International | Custom string to be inserted as a placeholder. |
searchCountryFlag | boolean | false | Enables input search box for countries in the flag dropdown. |
searchCountryField | <SearchCountryField>[] | [SearchCountryField.All] | Customize which fields to search in, if searchCountryFlag is enabled. Use SearchCountryField helper enum. |
searchCountryPlaceholder | string | 'Search Country' | Placeholder value for searchCountryField |
maxLength | number | None | Add character limit. |
selectFirstCountry | boolean | true | Selects first country from preferredCountries if is set. If not then uses main list. |
phoneValidation | boolean | true | Disable phone validation. |
inputId | string | phone | Unique ID for <input> element. |
selectedCountryISO | <CountryISO> | None | Set specific country on load. |
separateDialCode | boolean | false | Visually separate dialcode into the drop down element. |
countryChange | <Country> | None | Emits country value when the user selects a country from the dropdown. |
Following formats are supported
./projects/ngx-intl-tel-input
./src/app
with new functionality.$ npm run build_lib
$ npm run copy-files
$ npm run npm_pack
$ npm run package
After building and creating package, you can use it locally too.
In your project run:
$ npm install --save {{path to your local '*.tgz' package file}}
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
No vulnerabilities found.
Reason
no dangerous workflow patterns detected
Reason
no binaries found in the repo
Reason
license file detected
Details
Reason
Found 0/11 approved changesets -- score normalized to 0
Reason
0 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 0
Reason
detected GitHub workflow tokens with excessive permissions
Details
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
Reason
security policy file not detected
Details
Reason
project is not fuzzed
Details
Reason
branch protection not enabled on development/release branches
Details
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
Reason
24 existing vulnerabilities detected
Details
Score
Last Scanned on 2025-06-30
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More