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))(); * * ``` * + * ### 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 `
` 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 `` element: + * + * ```html + * + * ... + *
+ * ``` + * * @ngModule FormsModule * @publicApi */