ngx-upper-case-directive
v2.0.0
Published
This directive helps to convert an input text value to upper case.
Downloads
2,925
Maintainers
Readme
Angular Upper Case Directive
This directive helps to convert an input text value to upper case.
It lies on a simple fact that Angular listens to input
event to bring the view-to-model binding into being.
* According to the description of updateOn property of AbstractControlOptions interface, when updateOn is set to blur
or submit
, Angular listens to blur
or submit
event for model update. In this directive, update-on-blur
case is handled in a hack way. No further processing is required for update-on-submit
case.
Since extra input
and blur
events are dispatched, if you bind a callback to input
event or blur
event, the callback will be invoked twice on input
or blur
.
To overcome the disadvantage, a debounced function is recommended for the event binding.
The directive works with Angular 5 and 6. To use it in Angular 4, you may import the .ts file directly (see Usage). For Angular 2, you may try it in Angular 4's way, but it's not tested.
Usage
1.Install ngx-upper-case-directive
.
npm i -S ngx-upper-case-directive
2.Import NgxUpperCaseDirectiveModule
to your Angular module.
Angular 4
import { NgxUpperCaseDirectiveModule } from 'ngx-upper-case-directive/src';
@NgModule({
imports: [
...
NgxUpperCaseDirectiveModule,
...
],
...
Angular 5+
import { NgxUpperCaseDirectiveModule } from 'ngx-upper-case-directive';
@NgModule({
imports: [
...
NgxUpperCaseDirectiveModule,
...
],
...
3.Add the "upperCase" attribute to an input element or a textarea element.
<input type="text" ... upperCase>
4.If you want to convert the value ONLY on blur event, you should set the value of upperCase attribute to blur
.
<textarea ... upperCase="blur"></textarea>
Good luck.