From 71c1891b69f5d401a6fc8707734a5ecc618f2a5e Mon Sep 17 00:00:00 2001
From: redhoodsu <redhoodsu@tencent.com>
Date: Tue, 8 Oct 2019 23:20:19 +0800
Subject: [PATCH] chore: small changes

---
 doc/UTIL_API.md            | 30 ++++++++++++++++
 src/DevTools/DevTools.js   |  9 +++--
 src/DevTools/DevTools.scss |  2 +-
 src/lib/util.js            | 71 ++++++++++++++++++++++++++++++++++++++
 4 files changed, 109 insertions(+), 3 deletions(-)

diff --git a/doc/UTIL_API.md b/doc/UTIL_API.md
index abde9d3..c8ead6a 100644
--- a/doc/UTIL_API.md
+++ b/doc/UTIL_API.md
@@ -1038,6 +1038,21 @@ dateFormat('yyyy-mm-dd HH:MM:ss'); // -> 2016-11-19 19:00:04
 dateFormat(new Date(), 'yyyy-mm-dd'); // -> 2016-11-19
 ```
 
+## debounce 
+
+Return a new debounced version of the passed function.
+
+|Name  |Type    |Desc                           |
+|------|--------|-------------------------------|
+|fn    |function|Function to debounce           |
+|wait  |number  |Number of milliseconds to delay|
+|return|function|New debounced function         |
+
+```javascript
+const calLayout = debounce(function () {}, 300);
+// $(window).resize(calLayout);
+```
+
 ## decodeUriComponent 
 
 Better decodeURIComponent that does not throw if input is invalid.
@@ -2412,6 +2427,21 @@ Strip html tags from a string.
 stripHtmlTag('<p>Hello</p>'); // -> 'Hello'
 ```
 
+## throttle 
+
+Return a new throttled version of the passed function.
+
+|Name  |Type    |Desc                           |
+|------|--------|-------------------------------|
+|fn    |function|Function to throttle           |
+|wait  |number  |Number of milliseconds to delay|
+|return|function|New throttled function         |
+
+```javascript
+const updatePos = throttle(function () {}, 100);
+// $(window).scroll(updatePos);
+```
+
 ## toArr 
 
 Convert value to an array.
diff --git a/src/DevTools/DevTools.js b/src/DevTools/DevTools.js
index 8ba2e84..48261a8 100644
--- a/src/DevTools/DevTools.js
+++ b/src/DevTools/DevTools.js
@@ -13,7 +13,8 @@ import {
   each,
   isNum,
   safeStorage,
-  $
+  $,
+  throttle
 } from '../lib/util'
 
 export default class DevTools extends Emitter {
@@ -243,6 +244,10 @@ export default class DevTools extends Emitter {
         $navBar.css('filter', 'brightness(1.2)')
       }, 1000)
     }
+    const setDisplaySize = throttle(
+      size => this.config.set('displaySize', size),
+      50
+    )
     const moveListener = e => {
       if (!this._isResizing) {
         return clearTimeout(this._resizeTimer)
@@ -260,7 +265,7 @@ export default class DevTools extends Emitter {
       } else if (displaySize > 100) {
         displaySize = 100
       }
-      this.config.set('displaySize', displaySize)
+      setDisplaySize(displaySize)
     }
     const endListener = () => {
       clearTimeout(this._resizeTimer)
diff --git a/src/DevTools/DevTools.scss b/src/DevTools/DevTools.scss
index 335d7ae..2c9a1b5 100644
--- a/src/DevTools/DevTools.scss
+++ b/src/DevTools/DevTools.scss
@@ -11,7 +11,7 @@
   z-index: 500;
   display: none;
   opacity: 0;
-  transition: opacity $anim-duration;
+  transition: opacity $anim-duration, height $anim-duration;
   .tools {
     @include overflow-auto();
     height: 100%;
diff --git a/src/lib/util.js b/src/lib/util.js
index bbf3b48..83ff355 100644
--- a/src/lib/util.js
+++ b/src/lib/util.js
@@ -531,6 +531,45 @@ export var toStr = _.toStr = (function (exports) {
     return exports;
 })({});
 
+/* ------------------------------ debounce ------------------------------ */
+
+export var debounce = _.debounce = (function (exports) {
+    /* Return a new debounced version of the passed function.
+     *
+     * |Name  |Type    |Desc                           |
+     * |------|--------|-------------------------------|
+     * |fn    |function|Function to debounce           |
+     * |wait  |number  |Number of milliseconds to delay|
+     * |return|function|New debounced function         |
+     */
+
+    /* example
+     * const calLayout = debounce(function () {}, 300);
+     * // $(window).resize(calLayout);
+     */
+
+    /* typescript
+     * export declare function debounce(fn: Function, wait: number): Function;
+     */
+    exports = function(fn, wait, immediate) {
+        var timeout;
+        return function() {
+            var ctx = this;
+            var args = arguments;
+
+            var throttler = function() {
+                timeout = null;
+                fn.apply(ctx, args);
+            };
+
+            if (!immediate) clearTimeout(timeout);
+            if (!immediate || !timeout) timeout = setTimeout(throttler, wait);
+        };
+    };
+
+    return exports;
+})({});
+
 /* ------------------------------ ucs2 ------------------------------ */
 
 export var ucs2 = _.ucs2 = (function (exports) {
@@ -8166,6 +8205,38 @@ export var stripHtmlTag = _.stripHtmlTag = (function (exports) {
     return exports;
 })({});
 
+/* ------------------------------ throttle ------------------------------ */
+
+export var throttle = _.throttle = (function (exports) {
+    /* Return a new throttled version of the passed function.
+     *
+     * |Name  |Type    |Desc                           |
+     * |------|--------|-------------------------------|
+     * |fn    |function|Function to throttle           |
+     * |wait  |number  |Number of milliseconds to delay|
+     * |return|function|New throttled function         |
+     */
+
+    /* example
+     * const updatePos = throttle(function () {}, 100);
+     * // $(window).scroll(updatePos);
+     */
+
+    /* typescript
+     * export declare function throttle(fn: Function, wait: number): Function;
+     */
+
+    /* dependencies
+     * debounce 
+     */
+
+    exports = function(fn, wait) {
+        return debounce(fn, wait, true);
+    };
+
+    return exports;
+})({});
+
 /* ------------------------------ tryIt ------------------------------ */
 
 export var tryIt = _.tryIt = (function (exports) {