From da797d3b0dc7f9ac60efe389cf61b6da2baac8e3 Mon Sep 17 00:00:00 2001
From: lonix1 <40320097+lonix1@users.noreply.github.com>
Date: Tue, 19 Mar 2024 03:17:27 +0200
Subject: [PATCH] docs: debounce

---
 README.MD | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.MD b/README.MD
index 7cb3756..6703b99 100644
--- a/README.MD
+++ b/README.MD
@@ -171,10 +171,22 @@ v.addProvider('io', (value, element, params) => {
 
 ## Controlling when validation occurs
 
+### Events
+
 By default, validation occurs immediately upon changes to form fields: on `input` for inputs and textareas, and on `change` for selects.
 
 One can change to a different event by setting a field's `data-val-event` attribute. For example, one can use `data-val-event="blur"` to validate that field on the `blur` event.
 
+### Timing
+
+To prevent unnecessary validation, a debounce of 300ms is used. This ensures validation does not occur for every keystroke, which is especially important during remote validation.
+
+In some cases it may be unnecessary, for example when performing local validation on blur (rather than on change). To change the default:
+
+```ts
+v.debounce = 0;
+```
+
 ## Subscribing to Client Form Validation Event
 
 ```ts