在 Angular 应用中,我们有两种方式来实现表单绑定——“模板驱动表单”与“响应式表单”。这两种方式通常能够很好的处理大部分的情况,但是对于一些特殊的表单控件,例如input[type=datetime]input[type=file],我们需要重写默认的表单绑定方式,让我们绑定的变量不再仅仅只是一个字符串,而是一个 Date 或者 File 对象。为了达成这一目的,我们需要自定义表单控件的 ControlValueAccessor

ControlValueAccessor 接口是 Angular Forms API 与 DOM 之间的桥梁,通过提供不同的 ControlValueAccessor,我们就可以使用统一的 Angular Forms API 来操作不同的 HTML 表单元素。

在我们使用 ngModel 或者 formControl 的时候,这两个 Directive 会向 Angular 的依赖注入容器申请实现了 ControlValueAccessor 接口的对象,这是一种典型的面向接口编程的设计。例如,如果我们需要为 input[type=file] 提供一个用来绑定 File 对象的 ControlValueAccessor,只需要在依赖注入容器中提供一个 FileControlValueAccessor 的实现就可以了。不过,我们并不想覆盖其他类型 input 元素的 ControlValueAccessor,因为那样肯定会对已有代码造成大范围的破坏。所以在这里,我们需要使用 Angular 的分层注入能力——在 ElementInjector 中提供 FileControlValueAccessor。关于 ElementInjector 更多的内容,请看这里 a-curios-case-of-the-host-decorator-and-element-injectors-in-angular。

下面演示的两个 Directive 您都可以在这里查看在线演示。

首先让我们来创建一个 Directive,这个指令将会选中 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 {// 当文件选择器选择的文件发生改变时调用的回调函数onChange: (any) => any;// 当文件选择器选择的被操作后调用的回调函数onTouched: () => any;// 监听宿主元素的 change 事件@HostListener('change', ['$event.target.files']) onElChange = (files: FileList) => {this.onChange(files);};// 监听宿主元素的 blur 事件@HostListener('blur', []) onElTouched = () => {this.onTouched();};constructor(private el: ElementRef<HTMLInputElement>) {     // <5>}ngOnInit(): void {this.el.nativeElement.addEventListener('change', this.listener);}// 来自 ControlValueAccessor 接口,用来设置元素的值writeValue(obj: any): void {this.el.nativeElement.value = obj;}// 来自 ControlValueAccessor 接口,用来将一个函数注册为 onChange 回调函数registerOnChange(fn: any): void {this.onChange = fn;}// 来自 ControlValueAccessor 接口,用来将一个函数注册为 onTouched 回调函数registerOnTouched(fn: any): void {this.onTouched = fn;}// 来自 ControlValueAccessor 接口,设置表单元素是否启用setDisabledState?(isDisabled: boolean): void {this.el.nativeElement.disabled = isDisabled;}}

上面的代码片段中你可以看到有几处类似 // <1> 的注释,这是我用来在下面的文章中引用该行代码的标记,语法借鉴自 ASCIIDoc

  1. 通过定义一个复合的选择器,我们可以有选择的对 input[type=file] 重写 ControlValueAccessor
  2. ControlValueAccessor 的注入 token 是一个常量 —— NG_VALUE_ACCESSOR
  3. 由于 Directive 的定义在这行代码的下面,所以需要使用 forwardRef 来引用这个依赖的实现。
  4. 这里需要将 multiple 设置为 true,因为 Angular 默认的 ControlValueAccessor 就是提供了多个实现的。在解析依赖的时候,Angular 会优先选择我们自定义的实现。
  5. 为了代码更加简单,我在这里选择了不利于服务端渲染的 ElementRef.nativeElement 来读取原生 HTML 元素的属性,如果你对服务端渲染有需求,你应该使用 Renderer2 来读写元素的属性。

有了这个 Directive,我们就可以在 Angular Forms 中绑定 File 对象了:

<input type="file" [(ngModel)]="foo.files" inputFile />

Date 类型的数据也是日常开发中比较头疼的一个地方,因为在 JSON 中,Date 类型往往会被序列化为字符串,而在前端代码中,我们又需要将其反序列化为 Date 对象,最终在页面上展示的时候,我们又需要按照产品需求再将其序列化为制定格式的字符串。现在,有了 ControlValueAccessor 的帮助,我们就可以实现让 input[type=datetime]Date 对象进行双向绑定的功能,同时还能够定制 Date 对象在输入框中的显示格式。

@Directive({// tslint:disable-next-line:directive-selectorselector: '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 });}/*** 设置组件的值的时候,先把新的值存到一个成员变量中,然后再把新的值格式化为 string*/writeValue(date: Date): void {this.dateValue = date;this.renderer.setProperty(this.element, 'value', this.formatDate(date));}/*** 在 input 元素值发生变化的时候,先尝试把变化后的值转换成 Date 对象* 如果转换失败,那么依然使用之前的值* 否则,将新的值传递给回调函数*/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);}
}
  1. 这里演示了使用 Renderer2 来读写元素属性的操作

整个指令的内容仍然非常简单,但是却能够为我们的日常开发带来不小的便利,使用了这个指令后,我们就可以非常容易的为 Date 对象进行双向绑定。

<input type="datetime" valueAsDate="M/d/yyyy h:mm:ss a" [(ngModel)]="foo.date">

转载于:https://www.cnblogs.com/JacZhu/p/10087447.html

Angular Forms - 自定义 ngModel 绑定值的方式相关推荐

  1. angular创建自定义指令的四种方式

    angular除了内置的部分指令,还可以通过.directive来自定义指令.要调用自定义指令,HTML 元素上需要添加自定义指令名.使用驼峰法来命名一个指令:nsHeader,在调用时使用需要-来分 ...

  2. Angular中数据文本绑定、绑定Html、绑定属性、双向数据绑定的实现方式

    场景 Angular介绍.安装Angular Cli.创建Angular项目入门教程: https://blog.csdn.net/BADAO_LIUMANG_QIZHI/article/detail ...

  3. angular 绑定自定义属性_Angular2实现自定义双向绑定属性

    整理文档,搜刮出一个Angular 2实现自定义 双向绑定 属性的代码,稍微整理精简一下做下分享. import { Component, OnInit, Output, Input, EventEm ...

  4. Excel透视表如何新增自定义列以及设置值汇总方式和值呈现方式

    1.透视表新增自定义列 例:按班级性别进行各科汇总,并新增各科权重求和列. (1)首先构建好简单的目标透视表. 结果如下图所示. 解释说明:将性别字段拖到"值"标签即默认计数. 一 ...

  5. vue中checkbox 样式自定义重写;循环遍历checkbox,拿到不同的v-model绑定值;及获取当前checked 状态,全选和全不选等功能。...

    开始写这个功能,不得不吐槽原始的checkbox,灰色小方块的丑陋,虽说eleUI,mintUI,等各种框架的单复选框已经对其优化,但还是不想要这种.那我们就来研究一下怎么处理它. <secti ...

  6. Angular实现数据双向绑定

    如果你了解Vue,那你就会习惯于Vue的数据双向绑定MVVM的模式,那么在Angular中能不能实现双向绑定呢?答案当然是可以的. 第一步:在app.module.ts文件中引入FormsModule ...

  7. Angular: [ControlValueAccessor] 自定义表单控件

    Angular: [ControlValueAccessor] 自定义表单控件 我们在实际开发中,通常会遇到各种各样的定制化功能,会遇到有些组件会与 Angular 的表单进行交互,这时候我们一般会从 ...

  8. angular的数据双向绑定

    以前我们通过jquery操作DOM可以实现数据绑定,但这样会使操作量加大,而在angular中可以轻松的实现数据双向绑定.数据双向绑定指的是数据改变,相应的视图发生改变,而用户操作视图,底层数据会发生 ...

  9. 细说 Angular 的自定义表单控件

    我们在构建企业级应用时,通常会遇到各种各样的定制化功能,因为每个企业都有自己独特的流程.思维方式和行为习惯.有很多时候,软件企业是不太理解这种情况,习惯性的会给出一个诊断,『你这么做不对,按逻辑应该这 ...

最新文章

  1. P1164 小A点菜
  2. 字符串与base64相互转换
  3. C#对Excel的一些操作【一】
  4. 清理AD过期对象,并将结果发送给指定管理员
  5. 【机器学习】一文归纳AI数据增强之法
  6. 【2021最新版】如何clean或者install Maven项目——IntelliJ IDEA系列教程
  7. 爬虫为什么使用asyncio以及邮件系统为什么使用celery
  8. 表变量与临时表的优缺点
  9. 不是程序员看不懂的21个梗,当你改错一行代码的时候...
  10. 并查集一般高级应用的理解
  11. 通往奥格瑞玛的道路-二分+最短路
  12. 25 年 IT 老兵零基础写小说,作品堪比《三体》| 人物志
  13. Shell之根据关键字符串替换文件中的行
  14. Oracle 批量修改字段长度
  15. C++ vector中begin()、end()、front()、back()的用法
  16. [Python36] 01 start
  17. w ndows7光盘安装,想装啥版装啥版:Windows7安装光盘版本转换软件
  18. 要善于借势破局——宁向东的清华管理学课第4课
  19. 手机上该怎么合并PDF?这个方法可不要错过
  20. Altium Designer(七)已有原理图生成原理图库

热门文章

  1. FLASH与E²PROM的区别
  2. (Z)使用SignalTAP II为了避免某些节点被弄丢, 必须要关闭的编译选项
  3. 感知算法论文(四):Mask Scoring R-CNN (2019)译文
  4. 机器学习实战(十一)利用PCA来简化数据
  5. md发布test-1 md发布test-1md发布test-1md发布test-1md发布test-1md发布test-1md发布test-1md发布test-1md发布test-1md发布test-
  6. 6月30日后支付宝还能正常提现吗?因为银行直连要停止了
  7. 房贷利率一涨再涨,为什么排队买房的越来越多?
  8. heap与stack区别
  9. 可以编辑的标签控件CStatic
  10. visual studio 调试python_Visual Studio Code Python 调试设置