Home  >  Article  >  Web Front-end  >  Detailed explanation of the ControlValueAccessor interface of Angular learning

Detailed explanation of the ControlValueAccessor interface of Angular learning

青灯夜游
青灯夜游forward
2023-03-10 20:03:232012browse

What is ControlValueAccessor? Why do you need to use ? The following article will introduce you to the ControlValueAccessor component interface in Angular. I hope it will be helpful to you!

Detailed explanation of the ControlValueAccessor interface of Angular learning

ControlValueAccessor What is it?

Simply put, ControlValueAccessor is an interface, which is used to create a bridge between Angular's FormControl instance and native DOM elements. Its usage is similar to OnInit, requiring programmers to implement corresponding methods in custom components.

import {
ControlValueAccessor,
NG_VALUE_ACCESSOR
} from '@angular/forms';

@Component({
    selector: 'custom',
    templateUrl: './custom.component.html',
    styleUrls: ['./custom.component.less'],
    providers: [     
      {
        provide: NG_VALUE_ACCESSOR, 
        useExisting: forwardRef(() => CustomComponent),
        multi: true     
      }   
    ]
})
export class CustomComponent implements ControlValueAccessor, OnInit, {…

Why you need to use ControlValueAccessor

Sometimes, you may need to create a custom form element and hope that it will work with Angular's FormControl communication. At this time you need ControlValueAccessor to achieve this purpose.

For example:

this.myForm = new FormGroup({
    userName: new FormControl({value: '', disabled: false})
});

    
             
    
             

In-depth understanding

The use of ControlValueAccessor is introduced on the Angular official website and many articles , but how exactly does it work?

Angular needs a common mechanism to bridge native/custom form controls and formControl directives, and this is exactly what ControlValueAccessor does. This object bridges native form controls and formControl directives and synchronizes their values. Any component or directive can be converted into an object of type ControlValueAccessor by implementing the ControlValueAccessor interface and registering it as NG_VALUE_ACCESSOR.

In fact, native form controls also have interfaces similar to ControlValueAccessor. For example: when Angular encounters input or textarea DOM native controls in the component template, it will use the DefaultValueAccessor directive

CheckboxControlValueAccessorinput[type=checkbox]##NumberValueAccessorinput[type=number]##RadioControlValueAccessorRangeValueAccessorSelectControlValueAccessorSelectMultipleControlValueAccessor

Accessor

##Form Element

DefaultValueAccessor

##input,textarea

input[type=radio]

input[type=range]

select

select[multiple]

以上是Angular 为所有原生 DOM 表单元素创建的 Angular 表单控件,即内置ControlValueAccessor

ControlValueAccessor 接口定义了四个方法:

  • - writeValue(obj:any):将表单模型中的新值写入视图或DOM属性(如果需要)的方法,它将来自外部的数据写入到内部的数据模型。

  • - registerOnChange(fn:any):一种注册处理程序的方法,当视图中的某些内容发生更改时应调用该处理程序。它具有一个告诉其他表单指令和表单控件以更新其值的函数。通常在 registerOnChange 中需要保存该事件触发函数,在数据改变的时候,可以通过调用事件触发函数通知外部数据变了,同时可以将修改后的数据作为参数传递出去。

  • - registerOnTouched(fn: any):注册 onTouched 事件,基本同 registerOnChange ,只是该函数用于通知表单组件已经处于 touched 状态,改变绑定的 FormControl 的内部状态。

  • - setDisabledState(isDisabled: boolean):当调用 FormControl 变更状态的 API 时得表单状态变为 Disabled 时调用 setDisabledState() 方法,以通知自定义表单组件当前表单的读写状态。

formControl 指令使用 writeValue 方法设置原生表单控件的值;使用 registerOnChange 方法来注册由每次原生表单控件值更新时触发的回调函数,我们需要把更新的值传给这个回调函数,这样对应的 Angular 表单控件值也会更新;使用 registerOnTouched 方法来注册用户和控件交互时触发的回调。

Detailed explanation of the ControlValueAccessor interface of Angular learning

formControl会调用名为setUpControl的函数,ControlValueAccessor的实例valueAccessor会被作为参数传入这个函数中。在setUpControl中,ControlValueAccessor的四个方法会在交互时被调用,以完成formControl和元素之间的通信。

拓展:

在使用ControlValueAccessor时需要一同引入NG_VALUE_ACCESSOR,它是使用InjectionToken 创建的可在 Provider 中使用的 Token。我们在编写自己的项目时一般不需要用到InjectionToken,但是在一个框架或者第三方的插件中,它就变得十分有必要了。

export const NG_VALUE_ACCESSOR =
    new InjectionToken<readonlyarray>>('NgValueAccessor');</readonlyarray>

试想当我使用依赖注入的功能时,我需要将我创建的依赖注册进组件中。这时我就需要一个令牌,如果我使用一个字符串作为令牌就有可能会造成重复,相同的令牌会导致后面的覆盖前面的。所以需要一个Token作为一个唯一值来防止这种冲突。

providers: [{ provide: TOKEN, useValue: … }]

更多编程相关知识,请访问:编程视频!!

The above is the detailed content of Detailed explanation of the ControlValueAccessor interface of Angular learning. For more information, please follow other related articles on the PHP Chinese website!

Statement:
This article is reproduced at:csdn.net. If there is any infringement, please contact admin@php.cn delete