npmpackage.info

ngx-mat-intl-tel-input

5.0.0

MIT

TypeScript

771.99 kB

Installations

npm install ngx-mat-intl-tel-input

Developer Guide

BETA

Typescript

No

Module System

ESM

Node Version

16.15.0

NPM Version

8.10.0 Pull Requests

Open

17

Total

94

Closed

36

Merged

41

Issues

Open

63

Total

102

Closed

39

Releases

4.0.0 Angular 11 Support

v4.0.0

Published on 25 Jan 2021

3.3.0

Published on 24 Oct 2020

As You Type support

v3.2.2

Published on 09 Sept 2020

Bug fixes

3.1.0

Published on 30 May 2020

Angular 8 and Material 8 support

2.5.0

Published on 09 Jan 2020

Issues fixes

2.0.2

Published on 22 Jun 2019

View all 8 releases

Contributors

Unable to fetch Contributors

View all 10 contributors

Languages

TypeScript

HTML

SCSS

JavaScript

TypeScript (72.09%)

HTML (11.65%)

SCSS (10.93%)

JavaScript (5.32%)

Love this project? Help keep it running — sponsor us today! 🚀

Developer

tanansatpal

Download Statistics

Total Downloads

1,744,158

Last Day

1,947

Last Week

8,480

Last Month

38,770

Last Year

539,789

GitHub Statistics

62 Stars

197 Commits

117 Forks

3 Watching

11 Branches

10 Contributors

Maintainers

Package Meta Information

Latest Version

5.0.0

Package Id

ngx-mat-intl-tel-input@5.0.0

Unpacked Size

771.99 kB

Size

341.82 kB

File Count

NPM Version

8.10.0

Node Version

16.15.0

Total Downloads

Cumulative downloads

Total Downloads

1,744,158

Last day

-5.9%

1,947

Compared to previous day

Last week

-17.2%

8,480

Compared to previous week

Last month

-0.2%

38,770

Compared to previous month

Last year

14.9%

539,789

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

tslib

Peer Dependencies

@angular/common @angular/core @angular/forms @angular/platform-browser @angular/platform-browser-dynamic libphonenumber-js

Versions

International Telephone Input for Angular Material (NgxMatIntlTelInput)

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.

Supports:

Angular 14
Angular Material 14
ReactiveFormsModule
FormsModule
Validation with libphonenumber-js

Installation

Install Dependencies

$ npm install libphonenumber-js --save

Install This Library

$ npm install ngx-mat-intl-tel-input --save

Usage

Import

Add NgxMatIntlTelInputComponent to your component file:

1imports: [NgxMatIntlTelInputComponent];

Example

Refer to main app in this repository for working example.

1<form #f="ngForm" [formGroup]="phoneForm">
2  <ngx-mat-intl-tel-input
3    [preferredCountries]="['us', 'gb']"
4    [enablePlaceholder]="true"
5    [enableSearch]="true"
6    name="phone"
7    describedBy="phoneInput"
8    formControlName="phone"
9  ></ngx-mat-intl-tel-input>
10</form>

1
2<form #f="ngForm" [formGroup]="phoneForm">
3  <ngx-mat-intl-tel-input
4  [preferredCountries]="['us', 'gb']"
5  [enablePlaceholder]="true"
6  [enableSearch]="true"
7  name="phone"
8  (countryChanged)="yourComponentMethodToTreatyCountryChangedEvent($event)" // $event is a instance of current select Country
9  formControlName="phone"></ngx-mat-intl-tel-input>
10</form>
11

If you want to show the sample number for the country selected or errors , use mat-hint anf mat-error as

1<form #f="ngForm" [formGroup]="phoneForm">
2  <ngx-mat-intl-tel-input
3    [preferredCountries]="['us', 'gb']"
4    [onlyCountries]="['us', 'gb', 'es']"
5    [enablePlaceholder]="true"
6    name="phone"
7    formControlName="phone"
8    #phone
9  ></ngx-mat-intl-tel-input>
10  <mat-hint>e.g. {{phone.selectedCountry.placeHolder}}</mat-hint>
11  <mat-error *ngIf="f.form.controls['phone']?.errors?.required"
12    >Required Field</mat-error
13  >
14  <mat-error *ngIf="f.form.controls['phone']?.errors?.validatePhoneNumber"
15    >Invalid Number</mat-error
16  >
17</form>

Options

| Options | Type | Default | Description | | ------------------ | ---------- | ----------- | ----------------------------------------------------------------------------------- | --- | | preferredCountries | string[] | [] | List of country abbreviations, which will appear at the top. | | onlyCountries | string[] | [] | List of manually selected country abbreviations, which will appear in the dropdown. | | | inputPlaceholder | string | undefined | Placeholder for the input component. | | enablePlaceholder | boolean | true | Input placeholder text, which adapts to the country selected. | | enableSearch | boolean | false | Whether to display a search bar to help filter down the list of countries | | format | string | default | Format of "as you type" input. Possible values: national, international, default | | describedBy | string | undefined | Use aria-described by with the input field |

Library Contributions

Fork repo.
Go to ./projects/ngx-mat-intl-tel-input
Update ./src/lib with new functionality.
Update README.md
Pull request.

Helpful commands

Build lib: $ npm run build_lib
Copy license and readme files: $ npm run copy-files
Create package: $ npm run npm_pack
Build lib and create package: $ npm run package

Use locally

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}}

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

4

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

3

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Signed-Releases

Determines if the project cryptographically signs release artifacts.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.1

/10

Last Scanned on 2025-01-27

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

Other packages similar to ngx-mat-intl-tel-input

ngx-mat-input-tel

19.0.0

@vidalsasun/ngx-mat-intl-tel-input

2.1.1

ngx-mat-intl-tel-input-v16

16.0.3

@timewalts/ngx-mat-intl-tel-input

5.0.6