茫茫人海中与你相遇

相信未来的你不会很差

作者：lx1036

来源：https://juejin.im/post/5abcc723f265da23830af99a

如果你正在做一个复杂项目，必然会需要自定义表单控件，这个控件主要需要实现 ControlValueAccessor 接口(译者注：该接口定义方法可参考 API 文档说明，也可参考 Angular 源码定义)。网上有大量文章描述如何实现这个接口，但很少说到它在 Angular 表单架构里扮演什么角色，如果你不仅仅想知道如何实现，还想知道为什么这样实现，那本文正合你的胃口。 首先我解释下为啥需要 ControlValueAccessor 接口以及它在 Angular 中是如何使用的。然后我将展示如何封装第三方组件作为 Angular 组件以及如何使用输入输出机制实现组件间通信(译者注：Angular 组件间通信输入输出机制可参考 官网文档)，最后将展示如何使用 ControlValueAccessor 来实现一种针对 Angular 表单新的数据通信机制。

FormControl 和 ControlValueAccessor

如果你之前使用过 Angular 表单，你可能会熟悉 FormControl ，Angular 官方文档将它描述为追踪单个表单控件值和有效性的实体对象。需要明白，不管你使用模板驱动还是响应式表单(译者注：即模型驱动)， FormControl 都总会被创建。如果你使用响应式表单，你需要显式创建 FormControl 对象，并使用 formControl 或 formControlName 指令来绑定原生控件；如果你使用模板驱动方法， FormControl 对象会被 NgModel指令隐式创建(译者注：可查看 Angular 源码 这一行)：

@Directive({  selector: '[ngModel]...',  ...})export class NgModel ... {  _control = new FormControl();   <---------------- here

不管 formControl 是隐式还是显式创建，都必须和原生 DOM 表单控件如 input,textarea 进行交互，并且很有可能需要自定义一个表单控件作为 Angular 组件而不是使用原生表单控件，而通常自定义表单控件会封装一个使用纯 JS 写的控件如 jQuery UI's Slider。本文我将使用原生表单控件术语来区分 Angular 特定的 formControl 和你在 html 使用的表单控件，但你需要知道任何一个自定义表单控件都可以和 formControl 指令进行交互，而不是原生表单控件如 input 。 原生表单控件数量是有限的，但是自定义表单控件是无限的，所以 Angular 需要一种通用机制来桥接原生/自定义表单控件和 formControl 指令，而这正是 ControlValueAccessor 干的事情。这个对象桥接原生表单控件和 formControl 指令，并同步两者的值。官方文档是这么描述的(译者注：为清晰理解，该描述不翻译)：

A ControlValueAccessor acts as a bridge between the Angular forms API and a native element in the DOM.

任何一个组件或指令都可以通过实现 ControlValueAccessor 接口并注册为 NG_VALUE_ACCESSOR ，从而转变成 ControlValueAccessor 类型的对象，稍后我们将一起看看如何做。另外，这个接口还定义两个重要方法—— writeValue 和 registerOnChange (译者注：可查看 Angular 源码 这一行)：

interface ControlValueAccessor {  writeValue(obj: any): void  registerOnChange(fn: any): void  registerOnTouched(fn: any): void  ...}

formControl 指令使用 writeValue 方法设置原生表单控件的值(译者注：你可能会参考 L186 和 L41)；使用 registerOnChange 方法来注册由每次原生表单控件值更新时触发的回调函数(译者注：你可能会参考这三行，L186 和 L43，以及 L85)，你需要把更新的值传给这个回调函数，这样对应的 Angular 表单控件值也会更新(译者注：这一点可以参考 Angular 它自己写的 DefaultValueAccessor 的写法是如何 把 input 控件每次更新值传给回调函数的，L52 和 L89)；使用 registerOnTouched 方法来注册用户和控件交互时触发的回调(译者注：你可能会参考 L95)。 下图是 Angular 表单控件 如何通过 ControlValueAccessor 来和原生表单控件交互的(译者注：formControl 和你写的或者 Angular 提供的 CustomControlValueAccessor 两个都是要绑定到 native DOM element 的指令，而 formControl指令需要借助 CustomControlValueAccessor 指令/组件，来和 native DOM element 交换数据。)：再次强调，不管是使用响应式表单显式创建还是使用模板驱动表单隐式创建， ControlValueAccessor 都总是和 Angular 表单控件进行交互。

Accessor	Form Elementv
DefaultValueAccessor	input,textarea
CheckboxControlValueAccessor	input[type=checkbox]
NumberValueAccessor	input[type=number]
RadioControlValueAccessor	input[type=radio]
RangeValueAccessor	input[type=range]
SelectControlValueAccessor	select
SelectMultipleControlValueAccessor	select[multiple]

从上表中可看到，当 Angular 在组件模板中中遇到 input 或 textarea DOM 原生控件时，会使用 DefaultValueAccessor 指令：

@Component({  selector: 'my-app',  template: `        `})export class AppComponent {  ctrl = new FormControl(3);}

所有表单指令，包括上面代码中的 formControl 指令，都会调用 setUpControl 函数来让表单控件和 DefaultValueAccessor 实现交互(译者注：意思就是上面代码中绑定的 实现交互(译者注：意思就是上面代码中绑定的 formControl 指令，在其自身实例化时，会调用 setUpControl() 函数给同样绑定到 input 的 DefaultValueAccessor 指令做好安装工作，如  L85，这样 formControl 指令就可以借助 DefaultValueAccessor 来和 input 元素交换数据了)。细节可参考 formControl 指令的代码：

export class FormControlDirective ... {  ...  ngOnChanges(changes: SimpleChanges): void {    if (this._isControlChanged(changes)) {      setUpControl(this.form, this);

还有setUpControl函数源码也指出了原生表单控件和 Angular 表单控件是如何数据同步的(译者注：作者贴的可能是 Angular v4.x 的代码，v5 有了点小小变动，但基本相似)：

export function setUpControl(control: FormControl, dir: NgControl) {  // initialize a form control  // 调用 writeValue() 初始化表单控件值  dir.valueAccessor.writeValue(control.value);  // setup a listener for changes on the native control  // and set this value to form control  // 设置原生控件值更新时监听器，每当原生控件值更新，Angular 表单控件值也更新  valueAccessor.registerOnChange((newValue: any) => {    control.setValue(newValue, {emitModelToViewChange: false});  });  // setup a listener for changes on the Angular formControl  // and set this value to the native control  // 设置 Angular 表单控件值更新监听器，每当 Angular 表单控件值更新，原生控件值也更新  control.registerOnChange((newValue: any, ...) => {    dir.valueAccessor.writeValue(newValue);  });

只要我们理解了内部机制，就可以实现我们自定义的 Angular 表单控件了。

组件封装器

由于 Angular 为所有默认原生控件提供了控件值访问器，所以在封装第三方插件或组件时，需要写一个新的控件值访问器。我们将使用上文提到的 jQuery UI 库的 slider 插件，来实现一个自定义表单控件吧。

简单的封装器

最基础实现是通过简单封装使其能在屏幕上显示出来，所以我们需要一个 NgxJquerySliderComponent 组件，并在其模板里渲染出 slider：

@Component({  selector: 'ngx-jquery-slider',  template: `        `,  styles: ['div {width: 100px}']})export class NgxJquerySliderComponent {  @ViewChild('location') location;  widget;  ngOnInit() {    this.widget = $(this.location.nativeElement).slider();  }}

这里我们使用标准的jQuery 方法在原生 DOM 元素上创建一个slider控件，然后使用 widget 属性引用这个控件。

一旦简单封装好了 slider 组件，我们就可以在父组件模板里使用它：

@Component({  selector: 'my-app',  template: `      

Hello {{name}}

`})export class AppComponent { ... }

为了运行程序我们需要加入 jQuery 相关依赖，简化起见，在 index.html 中添加全局依赖：

这里是安装依赖的 源码。

交互式表单控件

上面的实现还不能让我们自定义的 slider 控件与父组件交互，所以还得使用输入/输出绑定来是实现组件间数据通信：

export class NgxJquerySliderComponent {  @ViewChild('location') location;  @Input() value;  @Output() private valueChange = new EventEmitter();  widget;  ngOnInit() {    this.widget = $(this.location.nativeElement).slider();    this.widget.slider('value', this.value);    this.widget.on('slidestop', (event, ui) => {      this.valueChange.emit(ui.value);    });  }  ngOnChanges() {    if (this.widget && this.widget.slider('value') !== this.value) {      this.widget.slider('value', this.value);    }  }}

一旦 slider 组件创建，就可以订阅 slidestop 一旦 slidestop 事件被触发了，就可以使用输出事件发射器 valueChanges 通知父组件。当然我们也可以使用 ngOnChanges 生命周期钩子来追踪输入属性 value 值的变化，一旦其值变化，我们就将该值设置为 slider 控件的值。 然后就是父组件中如何使用 slider 组件的代码实现：

<ngx-jquery-slider    [value]="sliderValue"    (valueChange)="onSliderValueChange($event)">ngx-jquery-slider>

源码 在这里。

但是，我们想要的是使用 slider 组件作为表单的一部分，并使用模板驱动表单或响应式表单的指令与其数据通信，那就需要让其实现 ControlValueAccessor 接口了。由于我们将实现的是新的组件通信方式，所以不需要标准的输入输出属性绑定方式，那就移除相关代码吧。(译者注：作者先实现标准的输入输出属性绑定的通信方式，又要删除，主要是为了引入新的表单组件交互方式，即 ControlValueAccessor 。)

实现自定义控件值访问器

实现自定义控件值访问器并不难，只需要两步：

1. 注册 NG_VALUE_ACCESSOR 提供者
2. 实现 ControlValueAccessor 接口

NG_VALUE_ACCESSOR 提供者用来指定实现了 ControlValueAccessor 接口的类，并且被 Angular 用来和 formControl 同步，通常是使用组件类或指令来注册。所有表单指令都是使用 NG_VALUE_ACCESSOR 标识来注入控件值访问器，然后选择合适的访问器(译者注：这句话可参考这两行代码，L175 和 L181)。要么选择DefaultValueAccessor 或者内置的数据访问器，否则 Angular 将会选择自定义的数据访问器，并且有且只有一个自定义的数据访问器(译者注：这句话参考 selectValueAccessor 源码实现)。 让我们首先定义提供者：

@Component({  selector: 'ngx-jquery-slider',  providers: [{    provide: NG_VALUE_ACCESSOR,    useExisting: NgxJquerySliderComponent,    multi: true  }]  ...})class NgxJquerySliderComponent implements ControlValueAccessor {...}

我们直接在组件装饰器里直接指定类名，然而 Angular 源码默认实现是放在类装饰器外面：

export const DEFAULT_VALUE_ACCESSOR: any = {  provide: NG_VALUE_ACCESSOR,  useExisting: forwardRef(() => DefaultValueAccessor),  multi: true};@Directive({  selector:'input',  providers: [DEFAULT_VALUE_ACCESSOR]  ...})export class DefaultValueAccessor implements ControlValueAccessor{} 

放在外面就需要使用 forwardRef ，关于原因可以参考 What is forwardRef in Angular and why we need it 。当实现自定义 controlValueAccessor ，我建议还是放在类装饰器里吧(译者注：个人建议还是学习 Angular 源码那样放在外面)。 一旦定义了提供者后，就让我们实现 controlValueAccessor 接口：

export class NgxJquerySliderComponent implements ControlValueAccessor {  @ViewChild('location') location;  widget;  onChange;  value;ngOnInit() {  this.widget = $(this.location.nativeElement).slider(this.value);   this.widget.on('slidestop', (event, ui) => {      this.onChange(ui.value);    });}writeValue(value) {    this.value = value;    if (this.widget && value) {      this.widget.slider('value', value);    }  }registerOnChange(fn) { this.onChange = fn;  }registerOnTouched(fn) {  }


由于我们对用户是否与组件交互不感兴趣，所以先把 registerOnTouched 置空吧。在registerOnChange 里我们简单保存了对回调函数 fn 的引用，，回调函数是由 formControl 指令传入的(译者注：参考 L85)，只要每次 slider 组件值发生改变，就会触发这个回调函数。在 writeValue 方法内我们把得到的值传给 slider 组件。

如果你把简单封装和 controlValueAccessor 封装进行比较，你会发现父子组件交互方式是不一样的，尽管封装的组件与 slider 组件的交互是一样的。你可能注意到 formControl 指令实际上简化了与父组件交互的方式。这里我们使用 writeValue 来向子组件写入数据，而在简单封装方法中使用 ngOnChanges ；调用 this.onChange 方法输出数据，而在简单封装方法中使用 this.valueChange.emit(ui.value) 。 现在，实现了 ControlValueAccessor 接口的自定义 slider 表单控件完整代码如下：

@Component({  selector: 'my-app',  template: `      

Hello {{name}}

Current slider value: {{ctrl.value}} "ctrl"> value]= `})export class AppComponent {ctrl = new FormControl(11); updateSlider($event) {this.ctrl.setValue($event.currentTarget.value, {emitModelToViewChange: true}); }}

你可以查看程序的 最终实现。

我们在虚拟的空间与你相遇，期待可以碰撞出不一样的火花

公众号ID：前端大联盟扫码关注最新动态