该错误意味着,当您将 aformControl
放在div
. 要解决此问题,您有两个选择。
- 您将
formControlName
放在一个元素上,该元素由 Angular 开箱即用。它们是:input
、textarea
和select
。
- 你实现
ControlValueAccessor
接口。通过这样做,您是在告诉 Angular “如何访问您的控件的值”(因此得名)。或者简单地说:该怎么做,当您将 aformControlName
放在一个元素上时,它自然没有与之关联的值。
现在,ControlValueAccessor
最初实现接口可能有点令人生畏。尤其是因为没有太多好的文档,您需要在代码中添加大量样板。因此,让我尝试通过一些易于遵循的步骤将其分解。
将您的表单控件移动到它自己的组件中
为了实现ControlValueAccessor
,您需要创建一个新组件(或指令)。将与表单控件相关的代码移到那里。像这样,它也很容易重复使用。组件内部已经有一个控件可能是您需要实现ControlValueAccessor
接口的首要原因,否则您将无法将自定义组件与 Angular 表单一起使用。
将样板添加到您的代码中
实现ControlValueAccessor
接口非常冗长,这是它附带的样板:
import {Component, OnInit, forwardRef} from '@angular/core';
import {ControlValueAccessor, FormControl, NG_VALUE_ACCESSOR} from '@angular/forms';
@Component({
selector: 'app-custom-input',
templateUrl: './custom-input.component.html',
styleUrls: ['./custom-input.component.scss'],
// a) copy paste this providers property (adjust the component name in the forward ref)
providers: [
{
provide: NG_VALUE_ACCESSOR,
useExisting: forwardRef(() => CustomInputComponent),
multi: true
}
]
})
// b) Add "implements ControlValueAccessor"
export class CustomInputComponent implements ControlValueAccessor {
// c) copy paste this code
onChange: any = () => {}
onTouch: any = () => {}
registerOnChange(fn: any): void {
this.onChange = fn;
}
registerOnTouched(fn: any): void {
this.onTouch = fn;
}
// d) copy paste this code
writeValue(input: string) {
// TODO
}
那么各个部分在做什么呢?
- a) 在运行时让 Angular 知道你实现了
ControlValueAccessor
接口
- b) 确保你正在实现
ControlValueAccessor
接口
- c) 这可能是最令人困惑的部分。基本上你正在做的是,你给了 Angular 覆盖你的类属性/方法的方法
onChange
,onTouch
并在运行时使用它自己的实现,这样你就可以调用这些函数。所以理解这一点很重要:您不需要自己实现 onChange 和 onTouch(除了最初的空实现)。您对 (c) 所做的唯一一件事就是让 Angular 将它自己的函数附加到您的类中。为什么?这样你就可以在适当的时候调用Angular 提供的onChange
和onTouch
方法。我们将在下面看到它是如何工作的。
- d)
writeValue
当我们实现它时,我们还将在下一节中看到该方法是如何工作的。我已经把它放在这里,所以所有必需的属性ControlValueAccessor
都被实现,你的代码仍然可以编译。
实现 writeValue
什么writeValue
是在你的自定义组件内部做一些事情,当表单控件在外部发生变化时。例如,如果您命名了自定义表单控件组件,app-custom-input
并且将在父组件中使用它,如下所示:
<form [formGroup]="form">
<app-custom-input formControlName="myFormControl"></app-custom-input>
</form>
然后writeValue
每当父组件以某种方式更改 的值时触发myFormControl
。例如,这可能是在表单 ( this.form = this.formBuilder.group({myFormControl: ""});
)的初始化期间或在表单重置时this.form.reset();
。
如果表单控件的值在外部发生变化,您通常想要做的是将其写入代表表单控件值的局部变量。例如,如果您CustomInputComponent
围绕基于文本的表单控件,它可能如下所示:
writeValue(input: string) {
this.input = input;
}
并在 html 中CustomInputComponent
:
<input type="text"
[ngModel]="input">
您也可以按照 Angular 文档中的描述将其直接写入输入元素。
现在您已经处理了当外部发生变化时组件内部发生的情况。现在让我们看看另一个方向。当组件内部发生变化时,您如何通知外部世界?
调用更改
下一步是通知父组件有关CustomInputComponent
. 这就是上面 (c)中的onChange
和onTouch
函数发挥作用的地方。通过调用这些函数,您可以将组件内部的更改通知给外部。为了将值的更改传播到外部,您需要使用新值作为参数调用 onChange。例如,如果用户input
在您的自定义组件的字段中键入某些内容,您将onChange
使用更新后的值调用:
<input type="text"
[ngModel]="input"
(ngModelChange)="onChange($event)">
如果你再次检查上面的实现 (c),你会看到发生了什么:Angular 将它自己的实现绑定到onChange
类属性。该实现需要一个参数,即更新的控制值。您现在所做的是调用该方法,从而让 Angular 了解更改。Angular 现在将继续更改外部的表单值。这是这一切的关键部分。您告诉 Angular 何时应该更新表单控件以及通过调用onChange
. 您已经为其提供了“访问控制值”的方法。
顺便说一句:名字onChange
是我自己选的。您可以在此处选择任何内容,例如propagateChange
或类似内容。不管你怎么命名它,它都是带有一个参数的相同函数,它由 Angular 提供,并且registerOnChange
在运行时通过方法绑定到你的类。
调用 onTouch
由于表单控件可以被“触摸”,您还应该让 Angular 了解何时您的自定义表单控件被触摸。您可以通过调用该onTouch
函数来做到这一点,您猜对了。因此,对于我们这里的示例,如果您想与 Angular 对开箱即用的表单控件的处理方式保持一致,您应该onTouch
在输入字段模糊时调用:
<input type="text"
[(ngModel)]="input"
(ngModelChange)="onChange($event)"
(blur)="onTouch()">
同样,onTouch
是我选择的名称,但它的实际功能是由 Angular 提供的,它采用零参数。这是有道理的,因为您只是让 Angular 知道表单控件已被触及。
把这一切放在一起
那么,当它们组合在一起时,它看起来如何呢?它应该是这样的:
// custom-input.component.ts
import {Component, OnInit, forwardRef} from '@angular/core';
import {ControlValueAccessor, FormControl, NG_VALUE_ACCESSOR} from '@angular/forms';
@Component({
selector: 'app-custom-input',
templateUrl: './custom-input.component.html',
styleUrls: ['./custom-input.component.scss'],
// Step 1: copy paste this providers property
providers: [
{
provide: NG_VALUE_ACCESSOR,
useExisting: forwardRef(() => CustomInputComponent),
multi: true
}
]
})
// Step 2: Add "implements ControlValueAccessor"
export class CustomInputComponent implements ControlValueAccessor {
// Step 3: Copy paste this stuff here
onChange: any = () => {}
onTouch: any = () => {}
registerOnChange(fn: any): void {
this.onChange = fn;
}
registerOnTouched(fn: any): void {
this.onTouch = fn;
}
// Step 4: Define what should happen in this component, if something changes outside
input: string;
writeValue(input: string) {
this.input = input;
}
// Step 5: Handle what should happen on the outside, if something changes on the inside
// in this simple case, we've handled all of that in the .html
// a) we've bound to the local variable with ngModel
// b) we emit to the ouside by calling onChange on ngModelChange
}
// custom-input.component.html
<input type="text"
[(ngModel)]="input"
(ngModelChange)="onChange($event)"
(blur)="onTouch()">
// parent.component.html
<app-custom-input [formControl]="inputTwo"></app-custom-input>
// OR
<form [formGroup]="form" >
<app-custom-input formControlName="myFormControl"></app-custom-input>
</form>
更多例子
嵌套表格
请注意,控制值访问器不是嵌套表单组的正确工具。对于嵌套的表单组,您可以简单地使用 an@Input() subform
代替。控制值访问器旨在包装controls
,而不是groups
! 请参阅此示例如何使用嵌套表单的输入:https : //stackblitz.com/edit/angular-nested-forms-input-2
来源