diff --git a/docs/content/guide/forms.ngdoc b/docs/content/guide/forms.ngdoc index 636163cc2e97..4c7b4a1ac3de 100644 --- a/docs/content/guide/forms.ngdoc +++ b/docs/content/guide/forms.ngdoc @@ -201,6 +201,8 @@ bind only to specified list of events. I.e. `ng-model-options="{ updateOn: 'blur and validate only after the control loses focus. You can set several events using a space delimited list. I.e. `ng-model-options="{ updateOn: 'mousedown blur' }"` +animation showing debounced input + If you want to keep the default behavior and just add new events that may trigger the model update and validation, add "default" as one of the specified events. @@ -238,6 +240,8 @@ You can delay the model update/validation by using the `debounce` key with the {@link ng.directive:ngModelOptions ngModelOptions} directive. This delay will also apply to parsers, validators and model flags like `$dirty` or `$pristine`. +animation showing debounced input + I.e. `ng-model-options="{ debounce: 500 }"` will wait for half a second since the last content change before triggering the model update and form validation. diff --git a/docs/img/guide/forms-debounce.gif b/docs/img/guide/forms-debounce.gif new file mode 100644 index 000000000000..52a0e6095a43 Binary files /dev/null and b/docs/img/guide/forms-debounce.gif differ diff --git a/docs/img/guide/forms-update-on-blur.gif b/docs/img/guide/forms-update-on-blur.gif new file mode 100644 index 000000000000..2d71520af0c0 Binary files /dev/null and b/docs/img/guide/forms-update-on-blur.gif differ