@saritasa/ngx-text-mask
v8.0.8
Published
Angular 2+ directive for input text masking
Downloads
31
Maintainers
Readme
Angular 4 Input Mask
Getting started
First, install it.
npm i @saritasa/ngx-text-mask --save
Then, import it into your @NgModule
:
import { NgModule } from '@angular/core';
import { FormsModule } from '@angular/forms';
import { TextMaskModule } from '@saritasa/ngx-text-mask';
@NgModule({
imports: [
FormsModule,
TextMaskModule
],
declarations: []
})
export class MyModule {}
Then, use it in your component:
@Component({
selector: 'app',
template: `
<input [textMask]="{mask: mask}" [(ngModel)]="myModel" type="text"/>
`
})
export class AppComponent {
public myModel = ''
public mask = ['(', /[1-9]/, /\d/, /\d/, ')', ' ', /\d/, /\d/, /\d/, '-', /\d/, /\d/, /\d/, /\d/]
}
Documentation
As you can see in the code above, you are passing an object to the textMask
directive.
For more information about the values that the textMask
object accepts, see
this page.
Other use-cases
Unmasking the value that is stored in the model
Text Mask does not provide an option to unmask the model before storing it. You can sanitize the model on your side. See here for details.
change
doesn't work
change
on an input field will not work if [text-mask]
is present. You can use (ngModelChange)
instead. For more
information, see this page.
Example
To see an example of the code running, follow these steps:
- Clone the repo,
git clone [email protected]:text-mask/text-mask.git
cd text-mask
cd angular2
npm install
npm start
- Open http://localhost:3000
The code of the example is in angular2/example
.
Ionic 2
Unfortunately, we are unable to support Ionic 2 ion-input
at this point as it overrides the ControlValueAccessor
that Text Mask requires to perform its job.