詳解Angular Forms中自定義ngModel綁定值的方式
在 Angular 應(yīng)用中,我們有兩種方式來(lái)實(shí)現(xiàn)表單綁定——“模板驅(qū)動(dòng)表單”與“響應(yīng)式表單”。這兩種方式通常能夠很好的處理大部分的情況,但是對(duì)于一些特殊的表單控件,例如 input[type=datetime] 、 input[type=file] ,我們需要重寫默認(rèn)的表單綁定方式,讓我們綁定的變量不再僅僅只是一個(gè)字符串,而是一個(gè) Date 或者 File 對(duì)象。為了達(dá)成這一目的,我們需要自定義表單控件的 ControlValueAccessor 。
ControlValueAccessor 接口是 Angular Forms API 與 DOM 之間的橋梁,通過(guò)提供不同的 ControlValueAccessor ,我們就可以使用統(tǒng)一的 Angular Forms API 來(lái)操作不同的 HTML 表單元素。
在我們使用 ngModel 或者 formControl 的時(shí)候,這兩個(gè) Directive 會(huì)向 Angular 的依賴注入容器申請(qǐng)實(shí)現(xiàn)了 ControlValueAccessor 接口的對(duì)象,這是一種典型的面向接口編程的設(shè)計(jì)。例如,如果我們需要為 input[type=file] 提供一個(gè)用來(lái)綁定 File 對(duì)象的 ControlValueAccessor ,只需要在依賴注入容器中提供一個(gè) FileControlValueAccessor 的實(shí)現(xiàn)就可以了。不過(guò),我們并不想覆蓋其他類型 input 元素的 ControlValueAccessor ,因?yàn)槟菢涌隙〞?huì)對(duì)已有代碼造成大范圍的破壞。所以在這里,我們需要使用 Angular 的分層注入能力——在 ElementInjector 中提供 FileControlValueAccessor 。關(guān)于 ElementInjector 更多的內(nèi)容,請(qǐng)看這里 a-curios-case-of-the-host-decorator-and-element-injectors-in-angular 。
下面演示的兩個(gè) Directive 您都可以在這里查看 在線演示 。
首先讓我們來(lái)創(chuàng)建一個(gè) Directive,這個(gè)指令將會(huì)選中 input[type=file][appInputFile]
元素,這樣我們就可以有選擇的為文件選擇器的 ElementInjector 定義新的 Provider。
@Directive({ selector: 'input[type=file][inputFile]', // <1> providers: [ { provide: NG_VALUE_ACCESSOR, // <2> useExisting: forwardRef(() => InputFileDirective), // <3> multi: true // <4> } ] }) export class InputFileDirective implements ControlValueAccessor, OnInit, OnDestroy { // 當(dāng)文件選擇器選擇的文件發(fā)生改變時(shí)調(diào)用的回調(diào)函數(shù) onChange: (any) => any; // 當(dāng)文件選擇器選擇的被操作后調(diào)用的回調(diào)函數(shù) onTouched: () => any; // 監(jiān)聽(tīng)宿主元素的 change 事件 @HostListener('change', ['$event.target.files']) onElChange = (files: FileList) => { this.onChange(files); }; // 監(jiān)聽(tīng)宿主元素的 blur 事件 @HostListener('blur', []) onElTouched = () => { this.onTouched(); }; constructor(private el: ElementRef<HTMLInputElement>) { // <5> } ngOnInit(): void { this.el.nativeElement.addEventListener('change', this.listener); } // 來(lái)自 ControlValueAccessor 接口,用來(lái)設(shè)置元素的值 writeValue(obj: any): void { this.el.nativeElement.value = obj; } // 來(lái)自 ControlValueAccessor 接口,用來(lái)將一個(gè)函數(shù)注冊(cè)為 onChange 回調(diào)函數(shù) registerOnChange(fn: any): void { this.onChange = fn; } // 來(lái)自 ControlValueAccessor 接口,用來(lái)將一個(gè)函數(shù)注冊(cè)為 onTouched 回調(diào)函數(shù) registerOnTouched(fn: any): void { this.onTouched = fn; } // 來(lái)自 ControlValueAccessor 接口,設(shè)置表單元素是否啟用 setDisabledState?(isDisabled: boolean): void { this.el.nativeElement.disabled = isDisabled; } }
上面的代碼片段中你可以看到有幾處類似 // <1>
的注釋,這是我用來(lái)在下面的文章中引用該行代碼的標(biāo)記,語(yǔ)法借鑒自 ASCIIDoc
- 通過(guò)定義一個(gè)復(fù)合的選擇器,我們可以有選擇的對(duì)
input[type=file]
重寫ControlValueAccessor
ControlValueAccessor
的注入 token 是一個(gè)常量 ——NG_VALUE_ACCESSOR
- 由于 Directive 的定義在這行代碼的下面,所以需要使用
forwardRef
來(lái)引用這個(gè)依賴的實(shí)現(xiàn)。 - 這里需要將 multiple 設(shè)置為 true,因?yàn)?Angular 默認(rèn)的
ControlValueAccessor
就是提供了多個(gè)實(shí)現(xiàn)的。在解析依賴的時(shí)候,Angular 會(huì)優(yōu)先選擇我們自定義的實(shí)現(xiàn)。 - 為了代碼更加簡(jiǎn)單,我在這里選擇了不利于服務(wù)端渲染的
ElementRef.nativeElement
來(lái)讀取原生 HTML 元素的屬性,如果你對(duì)服務(wù)端渲染有需求,你應(yīng)該使用Renderer2
來(lái)讀寫元素的屬性。
有了這個(gè) Directive,我們就可以在 Angular Forms 中綁定 File 對(duì)象了:
<input type="file" [(ngModel)]="foo.files" inputFile />
Date 類型的數(shù)據(jù)也是日常開(kāi)發(fā)中比較頭疼的一個(gè)地方,因?yàn)樵?JSON 中, Date 類型往往會(huì)被序列化為字符串,而在前端代碼中,我們又需要將其反序列化為 Date 對(duì)象,最終在頁(yè)面上展示的時(shí)候,我們又需要按照產(chǎn)品需求再將其序列化為制定格式的字符串。現(xiàn)在,有了 ControlValueAccessor
的幫助,我們就可以實(shí)現(xiàn)讓 input[type=datetime]
與 Date
對(duì)象進(jìn)行雙向綁定的功能,同時(shí)還能夠定制 Date 對(duì)象在輸入框中的顯示格式。
@Directive({ // tslint:disable-next-line:directive-selector selector: 'input[type=datetime][valueAsDate]', providers: [ { provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => DateValueDirective), multi: true } ] }) export class DateValueDirective implements ControlValueAccessor { /** * See https://date-fns.org/v2.0.0-alpha.25/docs/format * 自定義日期展示格式 * @type {string} * @memberof DateValueDirective */ // tslint:disable-next-line:no-input-rename @Input('valueAsDate') format: string; private dateValue: Date; @HostListener('input', ['$event.target.value']) onChange = (_: any) => { }; @HostListener('blur', []) onTouched = () => { }; get element() { return this.elementRef.nativeElement; } constructor( private elementRef: ElementRef, private renderer: Renderer2 // <1> ) { } parseDate(str: string) { return parseDate(str, this.format, new Date(), { awareOfUnicodeTokens: true }); } formatDate(date: Date) { return formatDate(date, this.format, { awareOfUnicodeTokens: true }); } /** * 設(shè)置組件的值的時(shí)候,先把新的值存到一個(gè)成員變量中,然后再把新的值格式化為 string */ writeValue(date: Date): void { this.dateValue = date; this.renderer.setProperty(this.element, 'value', this.formatDate(date)); } /** * 在 input 元素值發(fā)生變化的時(shí)候,先嘗試把變化后的值轉(zhuǎn)換成 Date 對(duì)象 * 如果轉(zhuǎn)換失敗,那么依然使用之前的值 * 否則,將新的值傳遞給回調(diào)函數(shù) */ registerOnChange(fn: any): void { const onChange = (value: string) => { const date = this.parseDate(value); if (isValidDate(date)) { this.dateValue = date; fn(date); } else { fn(this.dateValue); } }; this.onChange = onChange; } registerOnTouched(fn: any): void { this.onTouched = fn; } setDisabledState?(isDisabled: boolean): void { this.renderer.setProperty(this.element, 'disabled', isDisabled); } }
這里演示了使用 Renderer2
來(lái)讀寫元素屬性的操作
整個(gè)指令的內(nèi)容仍然非常簡(jiǎn)單,但是卻能夠?yàn)槲覀兊娜粘i_(kāi)發(fā)帶來(lái)不小的便利,使用了這個(gè)指令后,我們就可以非常容易的為 Date 對(duì)象進(jìn)行雙向綁定。
<input type="datetime" valueAsDate="M/d/yyyy h:mm:ss a" [(ngModel)]="foo.date">
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- angular4自定義表單控件[(ngModel)]的實(shí)現(xiàn)
- Angularjs之ngModel中的值驗(yàn)證綁定方法
- 解決angular2在雙向數(shù)據(jù)綁定時(shí)[(ngModel)]無(wú)法使用的問(wèn)題
- Angular 2 ngForm中的ngModel、[ngModel]和[(ngModel)]的寫法
- 淺談Angular中ngModel的$render
- AngularJS實(shí)踐之使用NgModelController進(jìn)行數(shù)據(jù)綁定
- AngularJS ngModel實(shí)現(xiàn)指令與輸入直接的數(shù)據(jù)通信
相關(guān)文章
AngularJS中ng-options實(shí)現(xiàn)下拉列表的數(shù)據(jù)綁定方法
今天小編就為大家分享一篇AngularJS中ng-options實(shí)現(xiàn)下拉列表的數(shù)據(jù)綁定方法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2018-08-08AngularJS基礎(chǔ) ng-hide 指令用法及示例代碼
本文主要介紹AngularJS ng-hide 指令,這里整理了ng-hide指令的基礎(chǔ)資料,并附實(shí)例代碼,有興趣的小伙伴參考下2016-08-08AngularJS中watch監(jiān)聽(tīng)用法分析
這篇文章主要介紹了AngularJS中watch監(jiān)聽(tīng)用法,較為詳細(xì)的分析了$watch的具體功能、相關(guān)參數(shù)用法與使用注意事項(xiàng),需要的朋友可以參考下2016-11-11angular或者js怎么確定選中ul中的哪幾個(gè)li
下面小編就為大家?guī)?lái)一篇angular或者js怎么確定選中ul中的哪幾個(gè)li。小編覺(jué)得挺不錯(cuò)的,現(xiàn)在就分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-08-08使用Angular CLI進(jìn)行Build(構(gòu)建)和Serve詳解
這篇文章主要介紹了使用Angular CLI進(jìn)行Build(構(gòu)建)和Serve詳解,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-03-03AngularJS實(shí)現(xiàn)頁(yè)面定時(shí)刷新
本篇文章主要介紹了AngularJS實(shí)現(xiàn)頁(yè)面定時(shí)刷新,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-03-03Angular.js自定義指令學(xué)習(xí)筆記實(shí)例
這篇文章主要介紹了Angular.js自定義指令的實(shí)例代碼,非常不錯(cuò),具有參考借鑒價(jià)值,需要的朋友可以參考下2017-02-02