update doc

dist/example/example.js

@@ -1517,6 +1517,12 @@
 	 *         onClick: function () { alert('确定') }
 	 *     }]
 	 * });
+	 * 
+	 * // 主动关闭
+	 * var $dialog = weui.dialog({...});
+	 * $dialog.hide(function(){
+	 *      console.log('`dialog` has been hidden');
+	 * });
 	 */
 	function dialog() {
 	    var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
@@ -1540,17 +1546,18 @@
 	    var $dialog = $dialogWrap.find('.weui-dialog');
 	    var $mask = $dialogWrap.find('.weui-mask');
 
-	    function _hide() {
+	    function _hide(callback) {
 	        _hide = _util2.default.noop; // 防止二次调用导致报错
 
 	        $mask.addClass('weui-animate-fade-out');
 	        $dialog.addClass('weui-animate-fade-out').on('animationend webkitAnimationEnd', function () {
 	            $dialogWrap.remove();
 	            _sington = false;
+	            callback && callback();
 	        });
 	    }
-	    function hide() {
-	        _hide();
+	    function hide(callback) {
+	        _hide(callback);
 	    }
 
 	    (0, _util2.default)('body').append($dialogWrap);
@@ -1968,8 +1975,15 @@
 /* 6 */
 /***/ function(module, exports) {
 
+	/*
+	object-assign
+	(c) Sindre Sorhus
+	@license MIT
+	*/
+
 	'use strict';
 	/* eslint-disable no-unused-vars */
+	var getOwnPropertySymbols = Object.getOwnPropertySymbols;
 	var hasOwnProperty = Object.prototype.hasOwnProperty;
 	var propIsEnumerable = Object.prototype.propertyIsEnumerable;
 
@@ -1990,7 +2004,7 @@
 			// Detect buggy property enumeration order in older V8 versions.
 
 			// https://bugs.chromium.org/p/v8/issues/detail?id=4118
-			var test1 = new String('abc');  // eslint-disable-line
+			var test1 = new String('abc');  // eslint-disable-line no-new-wrappers
 			test1[5] = 'de';
 			if (Object.getOwnPropertyNames(test1)[0] === '5') {
 				return false;
@@ -2019,7 +2033,7 @@
 			}
 
 			return true;
-		} catch (e) {
+		} catch (err) {
 			// We don't expect any of the above to throw, but better to be safe.
 			return false;
 		}
@@ -2039,8 +2053,8 @@
 				}
 			}
 
-			if (Object.getOwnPropertySymbols) {
-				symbols = Object.getOwnPropertySymbols(from);
+			if (getOwnPropertySymbols) {
+				symbols = getOwnPropertySymbols(from);
 				for (var i = 0; i < symbols.length; i++) {
 					if (propIsEnumerable.call(from, symbols[i])) {
 						to[symbols[i]] = from[symbols[i]];
@@ -2402,7 +2416,9 @@
 	 *     className: 'custom-classname'
 	 * });
 	 * setTimeout(function () {
-	 *     loading.hide();
+	 *     loading.hide(function() {
+	 *          console.log('`loading` has been hidden');
+	 *      });
 	 * }, 3000);
 	 */
 	function loading() {
@@ -2420,17 +2436,18 @@
 	    var $loading = $loadingWrap.find('.weui-toast');
 	    var $mask = $loadingWrap.find('.weui-mask');
 
-	    function _hide() {
+	    function _hide(callback) {
 	        _hide = _util2.default.noop; // 防止二次调用导致报错
 
 	        $mask.addClass('weui-animate-fade-out');
 	        $loading.addClass('weui-animate-fade-out').on('animationend webkitAnimationEnd', function () {
 	            $loadingWrap.remove();
 	            _sington = false;
+	            callback && callback();
 	        });
 	    }
-	    function hide() {
-	        _hide();
+	    function hide(callback) {
+	        _hide(callback);
 	    }
 
 	    (0, _util2.default)('body').append($loadingWrap);
@@ -2513,6 +2530,12 @@
 	 * ], {
 	 *     className: 'custom-classname'
 	 * });
+	 * 
+	 * // 主动关闭
+	 * var $actionSheet = weui.actionSheet({...});
+	 * $actionSheet.hide(function() {
+	 *      console.log('`actionSheet` has been hidden');
+	 * });
 	 */
 	function actionSheet() {
 	    var menus = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
@@ -2532,17 +2555,18 @@
 	    var $actionSheet = $actionSheetWrap.find('.weui-actionsheet');
 	    var $actionSheetMask = $actionSheetWrap.find('.weui-mask');
 
-	    function _hide() {
+	    function _hide(callback) {
 	        _hide = _util2.default.noop; // 防止二次调用导致报错
 
 	        $actionSheet.addClass(isAndroid ? 'weui-animate-fade-out' : 'weui-animate-slide-down');
 	        $actionSheetMask.addClass('weui-animate-fade-out').on('animationend webkitAnimationEnd', function () {
 	            $actionSheetWrap.remove();
 	            _sington = false;
+	            callback && callback();
 	        });
 	    }
-	    function hide() {
-	        _hide();
+	    function hide(callback) {
+	        _hide(callback);
 	    }
 
 	    (0, _util2.default)('body').append($actionSheetWrap);
@@ -2603,6 +2627,7 @@
 	 * @param {string} content 报错的文字
 	 * @param {number|function|object=} options 多少毫秒后消失|消失后的回调|配置项
 	 * @param {number=} [options.duration=3000] 多少毫秒后消失
+	 * @param {string=} options.className 自定义类名
 	 * @param {function=} options.callback 消失后的回调
 	 *
 	 * @example
@@ -2614,6 +2639,12 @@
 	 *     className: 'custom-classname',
 	 *     callback: function(){ console.log('close') }
 	 * });
+	 * 
+	 * // 主动关闭
+	 * var $topTips = weui.topTips('请填写正确的字段');
+	 * $topTips.hide(function() {
+	 *      console.log('`topTips` has been hidden');
+	 * });
 	 */
 	function topTips(content) {
 	    var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
@@ -2638,15 +2669,16 @@
 	    }, options);
 
 	    var $topTips = (0, _util2.default)(_util2.default.render(_topTips2.default, options));
-	    function _hide() {
+	    function _hide(callback) {
 	        _hide = _util2.default.noop; // 防止二次调用导致报错
 
 	        $topTips.remove();
+	        callback && callback();
 	        options.callback();
 	        _toptips = null;
 	    }
-	    function hide() {
-	        _hide();
+	    function hide(callback) {
+	        _hide(callback);
 	    }
 
 	    (0, _util2.default)('body').append($topTips);
@@ -3711,7 +3743,7 @@
 	 * @param {array} items picker的数据，即用于生成picker的数据，picker的层级可以自己定义，但建议最多三层。数据格式参考example。
 	 * @param {Object} options 配置项
 	 * @param {number=} [options.depth] picker深度(也就是picker有多少列) 取值为1-3。如果为空，则取items第一项的深度。
-	 * @param {string=} [options.id=default] 作为picker的唯一标识
+	 * @param {string=} [options.id=default] 作为picker的唯一标识，作用是以id缓存当时的选择。（当你想每次传入的defaultValue都是不一样时，可以使用不同的id区分）
 	 * @param {string=} [options.className] 自定义类名
 	 * @param {array=} [options.defaultValue] 默认选项的value数组
 	 * @param {function=} [options.onChange] 在picker选中的值发生变化的时候回调
@@ -3890,17 +3922,18 @@
 	        $picker.find('.weui-mask').addClass('weui-animate-fade-in');
 	        $picker.find('.weui-picker').addClass('weui-animate-slide-up');
 	    }
-	    function _hide() {
+	    function _hide(callback) {
 	        _hide = _util2.default.noop; // 防止二次调用导致报错
 
 	        $picker.find('.weui-mask').addClass('weui-animate-fade-out');
 	        $picker.find('.weui-picker').addClass('weui-animate-slide-down').on('animationend webkitAnimationEnd', function () {
 	            $picker.remove();
 	            _sington = false;
+	            callback && callback();
 	        });
 	    }
-	    function hide() {
-	        _hide();
+	    function hide(callback) {
+	        _hide(callback);
 	    }
 
 	    // 初始化滚动的方法
@@ -4637,7 +4670,9 @@
 	 *     className: 'custom-classname',
 	 *     onDelete: function(){
 	 *         if(confirm('确定删除该图片？')){ console.log('删除'); }
-	 *         gallery.hide();
+	 *         gallery.hide(function() {
+	 *              console.log('`gallery` has been hidden');
+	 *          });
 	 *     }
 	 * });
 	 */
@@ -4655,16 +4690,17 @@
 	        url: url
 	    }, options)));
 
-	    function _hide() {
+	    function _hide(callback) {
 	        _hide = _util2.default.noop; // 防止二次调用导致报错
 
 	        $gallery.addClass('weui-animate-fade-out').on('animationend webkitAnimationEnd', function () {
 	            $gallery.remove();
 	            _sington = false;
+	            callback && callback();
 	        });
 	    }
-	    function hide() {
-	        _hide();
+	    function hide(callback) {
+	        _hide(callback);
 	    }
 
 	    (0, _util2.default)('body').append($gallery);