From 9a550202860e699d342a587c26ea842894965058 Mon Sep 17 00:00:00 2001
From: Francesco Leardini <piolag@gmail.com>
Date: Wed, 5 Feb 2020 15:59:06 +0100
Subject: [PATCH] docs: added description for `novalidate` form attribute.
 (#35166)

PR Close #35166
---
 packages/forms/src/directives/ng_form.ts | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/forms/src/directives/ng_form.ts b/packages/forms/src/directives/ng_form.ts
index 674664f645..1014eb8d7e 100644
--- a/packages/forms/src/directives/ng_form.ts
+++ b/packages/forms/src/directives/ng_form.ts
@@ -90,6 +90,20 @@ const resolvedPromise = (() => Promise.resolve(null))();
  * </form>
  * ```
  *
+ * ### Native DOM validation UI
+ *
+ * In order to prevent the native DOM form validation UI from interfering with Angular's form
+ * validation, Angular automatically adds the `novalidate` attribute on any `<form>` whenever
+ * `FormModule` or `ReactiveFormModule` are imported into the application.
+ * If you want to explicitly enable native DOM validation UI with Angular forms, you can add the
+ * `ngNativeValidate` attribute to the `<form>` element:
+ *
+ * ```html
+ * <form ngNativeValidate>
+ *   ...
+ * </form>
+ * ```
+ *
  * @ngModule FormsModule
  * @publicApi
  */