NgFormlink
Creates a top-level FormGroup instance and binds it to a form to track aggregate form value and validation status.
创建一个顶级的 FormGroup 实例,并把它绑定到一个表单,以跟踪表单的聚合值及其验证状态。
选择器
输入参数
ngFormOptions 绑定到 NgForm.options 输出参数
ngSubmit 绑定到 NgForm.ngSubmit 导出为
说明
As soon as you import the FormsModule, this directive becomes active by default on all <form> tags. You don't need to add a special selector.
只要你导入了 FormsModule,该指令就会默认在所有 <form> 标签上生效。你不需要再添加任何特殊的选择器。
You can export the directive into a local template variable using ngForm as the key (ex: #myForm="ngForm"). This is optional, but useful. Many properties from the underlying FormGroup instance are duplicated on the directive itself, so a reference to it will give you access to the aggregate value and validity status of the form, as well as user interaction properties like dirty and touched.
你可以以 ngForm 作为 key 把该指令导出到一个局部模板变量(如 #myForm="ngForm")。这是可选的,但很有用。 来自本指令背后的 FormGroup 实例的很多属性,都被复制到了指令自身,所以拿到一个对该指令的引用就可以让你访问此表单的聚合值和验证状态, 还有那些用户交互类的属性,比如 dirty 和 touched。
To register child controls with the form, you'll want to use NgModel with a name attribute. You can also use NgModelGroup if you'd like to create sub-groups within the form.
如果要通过表单注册子控件,你还要使用一个带有 name 属性的 NgModel。你还可以使用 NgModelGroup 在表单中创建子组。
You can listen to the directive's ngSubmit event to be notified when the user has triggered a form submission. The ngSubmit event will be emitted with the original form submission event.
你可以监听该指令的 ngSubmit 事件,以便当用户触发了一次表单提交时得到通知。发出 ngSubmit 事件时,会携带原始的 DOM 表单提交事件。
In template driven forms, all <form> tags are automatically tagged as NgForm. If you want to import the FormsModule but skip its usage in some forms, for example, to use native HTML5 validation, you can add ngNoForm and the <form> tags won't create an NgForm directive. In reactive forms, using ngNoForm is unnecessary because the <form> tags are inert. In that case, you would refrain from using the formGroup directive.
在模板驱动表单中,所有 <form> 标签都会自动应用上 NgForm 指令。 如果你只想导入 FormsModule 而不想把它应用于某些表单中,比如,要想使用 HTML5 验证,你可以添加 ngNoForm 属性, 这样标签就不会在 <form> 上创建 NgForm 指令了。 在响应式表单中,则不需要用 ngNoForm,因为 NgForm 指令不会自动应用到 <form> 标签上,你只要别主动添加 formGroup 指令就可以了。
npm package:
@angular/formsNgModule:
FormsModule
属性
| 属性名 | 类型 | 说明 |
|---|---|---|
| submitted | 只读 | |
| form | ||
| ngSubmit | ||
| options | Options for the
updateOn: Serves as the default updateOn:为所有子级的 | |
| formDirective | 只读 | |
| control | 只读 | |
| path | 只读 | |
| controls | 只读 |
方法
参数没有参数。 |
参数
返回值
|
参数
返回值 |
参数
返回值
|
参数
返回值
|
参数
返回值
|
参数
返回值 |
参数
返回值
|
参数
返回值
|
参数
返回值
|
参数没有参数。 返回值
|
参数
返回值
|