[ngDefaultControl]
第三方控件需要ControlValueAccessor
使用 angular 表单才能运行。其中许多,如 Polymer 的<paper-input>
,表现得像<input>
原生元素,因此可以使用DefaultValueAccessor
. 添加一个ngDefaultControl
属性将允许他们使用该指令。
<paper-input ngDefaultControl [(ngModel)]="value>
或者
<paper-input ngDefaultControl formControlName="name">
所以这就是引入这个属性的主要原因。
它在 angular2 的 alpha 版本中被称为ng-default-control
属性。
DefaultValueAccessor指令ngDefaultControl
的选择器之一也是如此:
@Directive({
selector:
'input:not([type=checkbox])[formControlName],
textarea[formControlName],
input:not([type=checkbox])[formControl],
textarea[formControl],
input:not([type=checkbox])[ngModel],
textarea[ngModel],
[ngDefaultControl]', <------------------------------- this selector
...
})
export class DefaultValueAccessor implements ControlValueAccessor {
这是什么意思?
这意味着我们可以将此属性应用于没有自己的值访问器的元素(如聚合物组件)。所以这个元素将从中获取行为DefaultValueAccessor
,我们可以将这个元素与角度形式一起使用。
否则,您必须提供自己的实现 ControlValueAccessor
控制值存取器
Angular文档说明
ControlValueAccessor 充当 Angular 表单 API 和 DOM 中的原生元素之间的桥梁。
让我们在简单的 angular2 应用程序中编写以下模板:
<input type="text" [(ngModel)]="userName">
要了解我们input
上面的行为,我们需要知道哪些指令应用于此元素。这里 angular 给出了一些错误提示:
未处理的Promise拒绝:模板解析错误:无法绑定到“ngModel”,因为它不是“输入”的已知属性。
好的,我们可以打开 SO 并得到答案:导入FormsModule
到您的@NgModule
:
@NgModule({
imports: [
...,
FormsModule
]
})
export AppModule {}
我们导入了它,一切都按预期工作。但是引擎盖下发生了什么?
FormsModule为我们导出以下指令:
@NgModule({
...
exports: [InternalFormsSharedModule, TEMPLATE_DRIVEN_DIRECTIVES]
})
export class FormsModule {}
经过一些调查,我们可以发现三个指令将应用于我们的 input
1) NgControlStatus
@Directive({
selector: '[formControlName],[ngModel],[formControl]',
...
})
export class NgControlStatus extends AbstractControlStatus {
...
}
2)吴模型
@Directive({
selector: '[ngModel]:not([formControlName]):not([formControl])',
providers: [formControlBinding],
exportAs: 'ngModel'
})
export class NgModel extends NgControl implements OnChanges,
3) DEFAULT_VALUE_ACCESSOR
@Directive({
selector:
`input:not([type=checkbox])[formControlName],
textarea[formControlName],
input:not([type=checkbox])formControl],
textarea[formControl],
input:not([type=checkbox])[ngModel],
textarea[ngModel],[ngDefaultControl]',
,,,
})
export class DefaultValueAccessor implements ControlValueAccessor {
NgControlStatus
指令只是操纵类一样ng-valid
,ng-touched
,ng-dirty
我们可以在这里省略。
DefaultValueAccesstor
NG_VALUE_ACCESSOR
在 providers 数组中提供令牌:
export const DEFAULT_VALUE_ACCESSOR: any = {
provide: NG_VALUE_ACCESSOR,
useExisting: forwardRef(() => DefaultValueAccessor),
multi: true
};
...
@Directive({
...
providers: [DEFAULT_VALUE_ACCESSOR]
})
export class DefaultValueAccessor implements ControlValueAccessor {
NgModel
指令注入在NG_VALUE_ACCESSOR
同一宿主元素上声明的构造函数令牌。
export NgModel extends NgControl implements OnChanges, OnDestroy {
constructor(...
@Optional() @Self() @Inject(NG_VALUE_ACCESSOR) valueAccessors: ControlValueAccessor[]) {
在我们的例子NgModel
中将注入DefaultValueAccessor
. 现在 NgModel 指令调用共享setUpControl
函数:
export function setUpControl(control: FormControl, dir: NgControl): void {
if (!control) _throwError(dir, 'Cannot find control with');
if (!dir.valueAccessor) _throwError(dir, 'No value accessor for form control with');
control.validator = Validators.compose([control.validator !, dir.validator]);
control.asyncValidator = Validators.composeAsync([control.asyncValidator !, dir.asyncValidator]);
dir.valueAccessor !.writeValue(control.value);
setUpViewChangePipeline(control, dir);
setUpModelChangePipeline(control, dir);
...
}
function setUpViewChangePipeline(control: FormControl, dir: NgControl): void
{
dir.valueAccessor !.registerOnChange((newValue: any) => {
control._pendingValue = newValue;
control._pendingDirty = true;
if (control.updateOn === 'change') updateControl(control, dir);
});
}
function setUpModelChangePipeline(control: FormControl, dir: NgControl): void {
control.registerOnChange((newValue: any, emitModelEvent: boolean) => {
// control -> view
dir.valueAccessor !.writeValue(newValue);
// control -> ngModel
if (emitModelEvent) dir.viewToModelUpdate(newValue);
});
}
这是正在运行的桥梁:
NgModel
设置控件(1)并调用dir.valueAccessor !.registerOnChange
方法。ControlValueAccessor
将回调存储在onChange
(2)属性中,并在input
事件发生(3)时触发此回调。最后updateControl
在回调中调用函数(4)
function updateControl(control: FormControl, dir: NgControl): void {
dir.viewToModelUpdate(control._pendingValue);
if (control._pendingDirty) control.markAsDirty();
control.setValue(control._pendingValue, {emitModelToViewChange: false});
}
其中 angular 调用形成 API control.setValue
。
这是其工作原理的简短版本。