From 79deeacbd7cd53d3e4480ffa292a8755b667d53a Mon Sep 17 00:00:00 2001 From: Kapunahele Wong Date: Mon, 2 Oct 2017 16:51:58 -0400 Subject: [PATCH] docs(aio): add copy about ngNoForm to NgForm API doc (#19561) PR Close #19561 --- packages/forms/src/directives/ng_form.ts | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/packages/forms/src/directives/ng_form.ts b/packages/forms/src/directives/ng_form.ts index c0b9bfb680..94fc94ef45 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`