From 7d61f8263be66d9a8eb73d8bd5248bd5f335b74c Mon Sep 17 00:00:00 2001
From: Eva Gagnon-Messier <egagnon@getchalk.com>
Date: Wed, 9 Oct 2019 11:46:30 -0300
Subject: [PATCH] docs: reintroduce throttle documentation (#11718)

---
 docs/pages/javascript-utilities.md | 41 ++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/pages/javascript-utilities.md b/docs/pages/javascript-utilities.md
index 5e15b6d29..0031ec688 100644
--- a/docs/pages/javascript-utilities.md
+++ b/docs/pages/javascript-utilities.md
@@ -179,6 +179,47 @@ $('#someId').on('scrollme.zf.trigger', handleScroll);
 $('#someId').on('resizeme.zf.trigger', handleResize);
 ```
 
+## Throttle
+`js/foundation.core.js`
+
+Many times when you create a callback, it's advantageous to add a delay in order to prevent it from being triggered multiple times. Foundation includes one type of callback delay: `throttle`.
+
+`Throttle` prevents a function from being executed more than once every n milliseconds. Throttling is often used in cases where it's disadvantageous to trigger a callback every time an event is triggered (during a continuous action), but you still want to trigger a reaction while the event is occurring. Examples of this would be reacting to the browser window being resized, or animating an element.
+
+### Without Delay
+```js
+// Button click handler
+$('.button').on('click', function(e){
+  // Handle Click
+});
+
+// Resize function
+$(window).on('resize', function(e){
+  // Do responsive stuff
+});
+```
+
+### With Delay
+```js
+// Throttled resize function
+$(window).on('resize', Foundation.utils.throttle(function(e){
+  // Do responsive stuff
+}, 300));
+```
+
+### Method Signature
+```js
+// Arguments:
+//    Func (Function): Function to be throttled.
+//
+//    Delay (Integer): Function execution threshold in milliseconds.
+//
+// Returns:
+//    Lazy_function (Function): Function with throttling applied.
+
+throttle(func, delay) { ... }
+```
+
 ## Miscellaneous
 
 Foundation includes a couple useful features in the core library that are used in many places, that you can tap into.
-- 
2.47.2