diff --git a/packages/forms/src/directives/ng_form.ts b/packages/forms/src/directives/ng_form.ts index 6f69007d69..99344e5355 100644 --- a/packages/forms/src/directives/ng_form.ts +++ b/packages/forms/src/directives/ng_form.ts @@ -48,6 +48,13 @@ const resolvedPromise = Promise.resolve(null); * triggered a form submission. The `ngSubmit` event will be emitted with the original form * submission event. * + * In template driven forms, all `
` 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 `` + * tags won't create an `NgForm` directive. In reactive forms, using `ngNoForm` is + * unnecessary because the `` tags are inert. In that case, you would + * refrain from using the `formGroup` directive. + * * {@example forms/ts/simpleForm/simple_form_example.ts region='Component'} * * * **npm package**: `@angular/forms`