@vxe-ui/core 3.4.31 → 3.4.33

package/es/index.esm.js

@@ -17,6 +17,7 @@ import { permission } from './src/permission';
 import { baseUtils } from './src/base-utils';
 import { domUtils } from './src/dom-utils';
 import { scrollbarUtils } from './src/scrollbar-utils';
+import { popperUtils } from './src/popper-utils';
 import { log } from './src/log';
 import { globalMixins } from './src/mixins';
 import { getSlotVNs } from './src/vm';
@@ -93,6 +94,7 @@ export const VxeUI = Object.assign(VxeCore, {
     baseUtils,
     domUtils,
     scrollbarUtils,
+    popperUtils,
     globalStore,
     component,
     getComponent,
@@ -121,6 +123,7 @@ export * from './src/permission';
 export * from './src/base-utils';
 export * from './src/dom-utils';
 export * from './src/scrollbar-utils';
+export * from './src/popper-utils';
 export * from './src/dataStore';
 export * from './src/mixins';
 export * from './src/vm';

package/es/src/base-utils.js

@@ -20,5 +20,20 @@ export const baseUtils = {
      */
     getDefVal(value, defVal) {
         return XEUtils.eqNull(value) ? defVal : value;
+    },
+    /**
+     * 判断是否启用
+     */
+    isEnabled(conf) {
+        return !!(conf && conf.enabled !== false);
+    },
+    /**
+     * 用于开关类型的配置项
+     * 局部启用规则：conf={}
+     * 局部禁用规则：conf={enabled:false}
+     * 全局默认启用规则：conf.enabled=true
+     */
+    hasEnableConf(conf, opts) {
+        return !!(opts && (conf ? opts.enabled !== false : opts.enabled));
     }
 };

package/es/src/core.js

@@ -1,4 +1,4 @@
-export const coreVersion = "3.4.31";
+export const coreVersion = "3.4.33";
 export const VxeCore = {
     coreVersion,
     uiVersion: '',

package/es/src/dom-utils.js

@@ -1,5 +1,61 @@
 import XEUtils from 'xe-utils';
+const reClsMap = {};
+function getClsRE(cls) {
+    if (!reClsMap[cls]) {
+        reClsMap[cls] = new RegExp(`(?:^|\\s)${cls}(?!\\S)`, 'g');
+    }
+    return reClsMap[cls];
+}
+/**
+ * 判断元素是否包含 class
+ */
+function hasClass(elem, cls) {
+    if (elem) {
+        if (elem.classList) {
+            return elem.classList.contains(cls);
+        }
+        return !!(elem.className && elem.className.match && elem.className.match(getClsRE(cls)));
+    }
+    return false;
+}
+/**
+ * 给元素删除 class
+ */
+function removeClass(elem, cls) {
+    if (elem && hasClass(elem, cls)) {
+        elem.className = elem.className.replace(getClsRE(cls), '');
+    }
+}
 export const domUtils = {
+    /**
+     * 判断是否像素px单位 '100px' | 100
+     */
+    isPx(val) {
+        return val && /^\d+(\.\d+)?(px)?$/.test(val);
+    },
+    /**
+     * 判断是否百分比%单位 '100%'
+     */
+    isScale(val) {
+        return val && /^\d+(\.\d+)?%$/.test(val);
+    },
+    /**
+     * 判断元素是否包含 class
+     */
+    hasClass,
+    /**
+     * 给元素删除 class
+     */
+    removeClass,
+    /**
+     * 给元素增加 class
+     */
+    addClass(elem, cls) {
+        if (elem && !hasClass(elem, cls)) {
+            removeClass(elem, cls);
+            elem.className = elem.className + ' ' + cls;
+        }
+    },
     /**
      * 生成 className
      */

package/es/src/log.js

@@ -6,7 +6,7 @@ function createLog(type, name) {
         return msg;
     };
 }
-const version = "3.4.31";
+const version = "3.4.33";
 export const log = {
     create: createLog,
     warn: createLog('warn', `v${version}`),

package/es/src/popper-utils.js

@@ -0,0 +1,188 @@
+import XEUtils from 'xe-utils';
+/**
+ * 获取包裹容器的元素
+ */
+function getWrapperElement(panelElem) {
+    if (!panelElem) {
+        return null;
+    }
+    const bodyEl = document.body;
+    const parentEl = panelElem.parentElement;
+    return (parentEl === bodyEl ? document.documentElement : parentEl) || null;
+}
+/**
+ * 获取插入到指定容器的元素或字符串
+  */
+function getAppendSelector(appendTo) {
+    const selectElem = appendTo && XEUtils.isFunction(appendTo) ? appendTo({}) : appendTo;
+    return selectElem || 'body';
+}
+/**
+ * 获取插入到指定容器的元素
+ */
+function getAppendElement(appendTo) {
+    const selectElem = getAppendSelector(appendTo);
+    if (XEUtils.isString(selectElem)) {
+        return document.querySelector(selectElem) || document.body;
+    }
+    return selectElem;
+}
+export const popperUtils = {
+    /**
+     * 更新位置
+     */
+    updatePlacement(targetElem, panelElem, options) {
+        const { defaultTop, defaultLeft, placement, defaultPlacement, appendTo, teleportTo, marginSize, isMinWidth } = Object.assign({
+            appendTo: '',
+            teleportTo: false,
+            marginSize: 18,
+            isMinWidth: true
+        }, options);
+        let panelPlacement = 'bottom';
+        let top = '';
+        let bottom = '';
+        let left = 0;
+        let minWidth = '';
+        let arrowLeft = '';
+        const stys = {};
+        if (panelElem && targetElem) {
+            const bodyEl = document.body;
+            const parentWrapperEl = getWrapperElement(teleportTo ? getAppendElement(appendTo) : panelElem);
+            if (parentWrapperEl) {
+                const targetWidth = targetElem.offsetWidth;
+                const targetHeight = targetElem.offsetHeight;
+                const panelWidth = panelElem.offsetWidth;
+                const panelHeight = panelElem.offsetHeight;
+                const parentWrapperRect = parentWrapperEl.getBoundingClientRect();
+                const panelRect = panelElem.getBoundingClientRect();
+                const targetRect = targetElem.getBoundingClientRect();
+                const visibleHeight = bodyEl.clientHeight;
+                const visibleWidth = bodyEl.clientWidth;
+                const parentWrapperScrollLeft = parentWrapperEl.scrollLeft;
+                const parentWrapperScrollTop = parentWrapperEl.scrollTop;
+                const parentWrapperOffsetLeft = parentWrapperRect.left;
+                const parentWrapperOffsetTop = parentWrapperRect.top;
+                const targetLeft = targetRect.left;
+                const targetTop = targetRect.top;
+                minWidth = targetElem.offsetWidth;
+                if (teleportTo) {
+                    left = (defaultLeft || (targetLeft - (panelWidth - targetWidth) / 2)) - parentWrapperScrollLeft;
+                    top = (defaultTop || (targetTop + targetHeight)) - parentWrapperScrollTop;
+                    if (placement === 'top') {
+                        panelPlacement = 'top';
+                        top = targetTop - panelHeight;
+                    }
+                    else if (!placement) {
+                        if (defaultPlacement === 'top') {
+                            panelPlacement = 'top';
+                            if (!defaultTop) {
+                                top = targetTop - panelHeight;
+                            }
+                            // 如果上面不够放，则向下
+                            if (top < marginSize) {
+                                panelPlacement = 'bottom';
+                                top = targetTop + targetHeight;
+                            }
+                            // 如果下面不够放，则向上（优先）
+                            if (top + panelHeight + marginSize > visibleHeight) {
+                                panelPlacement = 'top';
+                                top = targetTop - panelHeight;
+                            }
+                        }
+                        else {
+                            // 如果下面不够放，则向上
+                            if (top + panelHeight + marginSize > visibleHeight) {
+                                panelPlacement = 'top';
+                                top = targetTop - panelHeight;
+                            }
+                            // 如果上面不够放，则向下（优先）
+                            if (top < marginSize) {
+                                panelPlacement = 'bottom';
+                                top = targetTop + targetHeight;
+                            }
+                        }
+                    }
+                    // 如果溢出右边
+                    if (left + panelWidth + marginSize > visibleWidth) {
+                        left -= left + panelWidth + marginSize - visibleWidth;
+                    }
+                    // 如果溢出左边
+                    if (left < marginSize) {
+                        left = marginSize;
+                    }
+                    // 偏移
+                    top -= parentWrapperOffsetTop;
+                    left -= parentWrapperOffsetLeft;
+                }
+                else {
+                    if (placement === 'top') {
+                        panelPlacement = 'top';
+                        bottom = targetHeight;
+                    }
+                    else if (!placement) {
+                        // 如果下面不够放，则向上
+                        top = targetHeight;
+                        if (targetTop + targetHeight + panelHeight + marginSize > visibleHeight) {
+                            // 如果上面不够放，则向下（优先）
+                            if (targetTop - targetHeight - panelHeight > marginSize) {
+                                panelPlacement = 'top';
+                                top = '';
+                                bottom = targetHeight;
+                            }
+                        }
+                    }
+                    // 是否超出右侧
+                    if (panelRect.left + panelRect.width + marginSize > visibleWidth) {
+                        left = -(panelRect.left + panelRect.width + marginSize - visibleWidth);
+                    }
+                }
+                if (XEUtils.isNumber(top)) {
+                    stys.top = top + 'px';
+                }
+                if (XEUtils.isNumber(bottom)) {
+                    stys.bottom = bottom + 'px';
+                }
+                if (XEUtils.isNumber(left)) {
+                    stys.left = left + 'px';
+                }
+                if (isMinWidth && XEUtils.isNumber(minWidth)) {
+                    stys.minWidth = minWidth + 'px';
+                }
+                // 箭头
+                if (left === targetLeft) {
+                    if (targetWidth <= panelWidth) {
+                        arrowLeft = targetWidth / 2;
+                    }
+                }
+                else if (left < targetLeft) {
+                    if (left + panelWidth > targetLeft + targetWidth) {
+                        arrowLeft = (targetLeft - left) + targetWidth / 2;
+                    }
+                    else {
+                        arrowLeft = (targetLeft - left) + (panelWidth - (targetLeft - left)) / 2;
+                    }
+                }
+            }
+        }
+        return {
+            top: top || 0,
+            bottom: bottom || 0,
+            left: left || 0,
+            arrowLeft: arrowLeft || 0,
+            style: stys,
+            placement: panelPlacement
+        };
+    },
+    /**
+     * 获取包裹容器的元素
+     */
+    getWrapperElement,
+    /**
+     * 获取插入到指定容器的元素或字符串
+     */
+    getAppendSelector,
+    /**
+     * 获取插入到指定容器的元素
+     */
+    getAppendElement
+};

package/lib/index.common.js

@@ -248,6 +248,18 @@ Object.keys(_scrollbarUtils).forEach(function (key) {
     }
   });
 });
+var _popperUtils = require("./src/popper-utils");
+Object.keys(_popperUtils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _popperUtils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _popperUtils[key];
+    }
+  });
+});
 var _log = require("./src/log");
 Object.keys(_log).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -360,6 +372,7 @@ const VxeUI = exports.VxeUI = Object.assign(_core.VxeCore, {
   baseUtils: _baseUtils.baseUtils,
   domUtils: _domUtils.domUtils,
   scrollbarUtils: _scrollbarUtils.scrollbarUtils,
+  popperUtils: _popperUtils.popperUtils,
   globalStore: _dataStore.globalStore,
   component,
   getComponent,

package/lib/index.umd.js

@@ -2534,6 +2534,7 @@ __webpack_require__.d(__webpack_exports__, {
   menus: function() { return /* reexport */ menus; },
   permission: function() { return /* reexport */ permission; },
   permissionMixin: function() { return /* reexport */ permissionMixin; },
+  popperUtils: function() { return /* reexport */ popperUtils; },
   renderCustomIcon: function() { return /* reexport */ renderCustomIcon; },
   renderEmptyElement: function() { return /* reexport */ renderEmptyElement; },
   renderGlobalIcon: function() { return /* reexport */ renderGlobalIcon; },
@@ -2570,7 +2571,7 @@ if (typeof window !== 'undefined') {
 // EXTERNAL MODULE: ./node_modules/core-js/modules/es.array.push.js
 var es_array_push = __webpack_require__(4114);
 ;// ./packages/src/core.ts
-const coreVersion = "3.4.31";
+const coreVersion = "3.4.33";
 const VxeCore = {
   coreVersion,
   uiVersion: '',
@@ -3223,7 +3224,7 @@ function createLog(type, name) {
     return msg;
   };
 }
-const version = "3.4.31";
+const version = "3.4.33";
 const log = {
   create: createLog,
   warn: createLog('warn', `v${version}`),
@@ -3673,12 +3674,83 @@ const baseUtils = {
    */
   getDefVal(value, defVal) {
     return external_root_XEUtils_commonjs_xe_utils_commonjs2_xe_utils_amd_xe_utils_default().eqNull(value) ? defVal : value;
+  },
+  /**
+   * 判断是否启用
+   */
+  isEnabled(conf) {
+    return !!(conf && conf.enabled !== false);
+  },
+  /**
+   * 用于开关类型的配置项
+   * 局部启用规则：conf={}
+   * 局部禁用规则：conf={enabled:false}
+   * 全局默认启用规则：conf.enabled=true
+   */
+  hasEnableConf(conf, opts) {
+    return !!(opts && (conf ? opts.enabled !== false : opts.enabled));
   }
 };
 ;// ./packages/src/dom-utils.ts
 
 
+const reClsMap = {};
+function getClsRE(cls) {
+  if (!reClsMap[cls]) {
+    reClsMap[cls] = new RegExp(`(?:^|\\s)${cls}(?!\\S)`, 'g');
+  }
+  return reClsMap[cls];
+}
+/**
+ * 判断元素是否包含 class
+ */
+function hasClass(elem, cls) {
+  if (elem) {
+    if (elem.classList) {
+      return elem.classList.contains(cls);
+    }
+    return !!(elem.className && elem.className.match && elem.className.match(getClsRE(cls)));
+  }
+  return false;
+}
+/**
+ * 给元素删除 class
+ */
+function removeClass(elem, cls) {
+  if (elem && hasClass(elem, cls)) {
+    elem.className = elem.className.replace(getClsRE(cls), '');
+  }
+}
 const domUtils = {
+  /**
+   * 判断是否像素px单位 '100px' | 100
+   */
+  isPx(val) {
+    return val && /^\d+(\.\d+)?(px)?$/.test(val);
+  },
+  /**
+   * 判断是否百分比%单位 '100%'
+   */
+  isScale(val) {
+    return val && /^\d+(\.\d+)?%$/.test(val);
+  },
+  /**
+   * 判断元素是否包含 class
+   */
+  hasClass,
+  /**
+   * 给元素删除 class
+   */
+  removeClass,
+  /**
+   * 给元素增加 class
+   */
+  addClass(elem, cls) {
+    if (elem && !hasClass(elem, cls)) {
+      removeClass(elem, cls);
+      elem.className = elem.className + ' ' + cls;
+    }
+  },
   /**
    * 生成 className
    */
@@ -3757,6 +3829,198 @@ const scrollbarUtils = {
     return thumbOffset / maxThumbOffset * maxScroll;
   }
 };
+;// ./packages/src/popper-utils.ts
+
+/**
+ * 获取包裹容器的元素
+ */
+function getWrapperElement(panelElem) {
+  if (!panelElem) {
+    return null;
+  }
+  const bodyEl = document.body;
+  const parentEl = panelElem.parentElement;
+  return (parentEl === bodyEl ? document.documentElement : parentEl) || null;
+}
+/**
+ * 获取插入到指定容器的元素或字符串
+  */
+function getAppendSelector(appendTo) {
+  const selectElem = appendTo && external_root_XEUtils_commonjs_xe_utils_commonjs2_xe_utils_amd_xe_utils_default().isFunction(appendTo) ? appendTo({}) : appendTo;
+  return selectElem || 'body';
+}
+/**
+ * 获取插入到指定容器的元素
+ */
+function getAppendElement(appendTo) {
+  const selectElem = getAppendSelector(appendTo);
+  if (external_root_XEUtils_commonjs_xe_utils_commonjs2_xe_utils_amd_xe_utils_default().isString(selectElem)) {
+    return document.querySelector(selectElem) || document.body;
+  }
+  return selectElem;
+}
+const popperUtils = {
+  /**
+   * 更新位置
+   */
+  updatePlacement(targetElem, panelElem, options) {
+    const {
+      defaultTop,
+      defaultLeft,
+      placement,
+      defaultPlacement,
+      appendTo,
+      teleportTo,
+      marginSize,
+      isMinWidth
+    } = Object.assign({
+      appendTo: '',
+      teleportTo: false,
+      marginSize: 18,
+      isMinWidth: true
+    }, options);
+    let panelPlacement = 'bottom';
+    let top = '';
+    let bottom = '';
+    let left = 0;
+    let minWidth = '';
+    let arrowLeft = '';
+    const stys = {};
+    if (panelElem && targetElem) {
+      const bodyEl = document.body;
+      const parentWrapperEl = getWrapperElement(teleportTo ? getAppendElement(appendTo) : panelElem);
+      if (parentWrapperEl) {
+        const targetWidth = targetElem.offsetWidth;
+        const targetHeight = targetElem.offsetHeight;
+        const panelWidth = panelElem.offsetWidth;
+        const panelHeight = panelElem.offsetHeight;
+        const parentWrapperRect = parentWrapperEl.getBoundingClientRect();
+        const panelRect = panelElem.getBoundingClientRect();
+        const targetRect = targetElem.getBoundingClientRect();
+        const visibleHeight = bodyEl.clientHeight;
+        const visibleWidth = bodyEl.clientWidth;
+        const parentWrapperScrollLeft = parentWrapperEl.scrollLeft;
+        const parentWrapperScrollTop = parentWrapperEl.scrollTop;
+        const parentWrapperOffsetLeft = parentWrapperRect.left;
+        const parentWrapperOffsetTop = parentWrapperRect.top;
+        const targetLeft = targetRect.left;
+        const targetTop = targetRect.top;
+        minWidth = targetElem.offsetWidth;
+        if (teleportTo) {
+          left = (defaultLeft || targetLeft - (panelWidth - targetWidth) / 2) - parentWrapperScrollLeft;
+          top = (defaultTop || targetTop + targetHeight) - parentWrapperScrollTop;
+          if (placement === 'top') {
+            panelPlacement = 'top';
+            top = targetTop - panelHeight;
+          } else if (!placement) {
+            if (defaultPlacement === 'top') {
+              panelPlacement = 'top';
+              if (!defaultTop) {
+                top = targetTop - panelHeight;
+              }
+              // 如果上面不够放，则向下
+              if (top < marginSize) {
+                panelPlacement = 'bottom';
+                top = targetTop + targetHeight;
+              }
+              // 如果下面不够放，则向上（优先）
+              if (top + panelHeight + marginSize > visibleHeight) {
+                panelPlacement = 'top';
+                top = targetTop - panelHeight;
+              }
+            } else {
+              // 如果下面不够放，则向上
+              if (top + panelHeight + marginSize > visibleHeight) {
+                panelPlacement = 'top';
+                top = targetTop - panelHeight;
+              }
+              // 如果上面不够放，则向下（优先）
+              if (top < marginSize) {
+                panelPlacement = 'bottom';
+                top = targetTop + targetHeight;
+              }
+            }
+          }
+          // 如果溢出右边
+          if (left + panelWidth + marginSize > visibleWidth) {
+            left -= left + panelWidth + marginSize - visibleWidth;
+          }
+          // 如果溢出左边
+          if (left < marginSize) {
+            left = marginSize;
+          }
+          // 偏移
+          top -= parentWrapperOffsetTop;
+          left -= parentWrapperOffsetLeft;
+        } else {
+          if (placement === 'top') {
+            panelPlacement = 'top';
+            bottom = targetHeight;
+          } else if (!placement) {
+            // 如果下面不够放，则向上
+            top = targetHeight;
+            if (targetTop + targetHeight + panelHeight + marginSize > visibleHeight) {
+              // 如果上面不够放，则向下（优先）
+              if (targetTop - targetHeight - panelHeight > marginSize) {
+                panelPlacement = 'top';
+                top = '';
+                bottom = targetHeight;
+              }
+            }
+          }
+          // 是否超出右侧
+          if (panelRect.left + panelRect.width + marginSize > visibleWidth) {
+            left = -(panelRect.left + panelRect.width + marginSize - visibleWidth);
+          }
+        }
+        if (external_root_XEUtils_commonjs_xe_utils_commonjs2_xe_utils_amd_xe_utils_default().isNumber(top)) {
+          stys.top = top + 'px';
+        }
+        if (external_root_XEUtils_commonjs_xe_utils_commonjs2_xe_utils_amd_xe_utils_default().isNumber(bottom)) {
+          stys.bottom = bottom + 'px';
+        }
+        if (external_root_XEUtils_commonjs_xe_utils_commonjs2_xe_utils_amd_xe_utils_default().isNumber(left)) {
+          stys.left = left + 'px';
+        }
+        if (isMinWidth && external_root_XEUtils_commonjs_xe_utils_commonjs2_xe_utils_amd_xe_utils_default().isNumber(minWidth)) {
+          stys.minWidth = minWidth + 'px';
+        }
+        // 箭头
+        if (left === targetLeft) {
+          if (targetWidth <= panelWidth) {
+            arrowLeft = targetWidth / 2;
+          }
+        } else if (left < targetLeft) {
+          if (left + panelWidth > targetLeft + targetWidth) {
+            arrowLeft = targetLeft - left + targetWidth / 2;
+          } else {
+            arrowLeft = targetLeft - left + (panelWidth - (targetLeft - left)) / 2;
+          }
+        }
+      }
+    }
+    return {
+      top: top || 0,
+      bottom: bottom || 0,
+      left: left || 0,
+      arrowLeft: arrowLeft || 0,
+      style: stys,
+      placement: panelPlacement
+    };
+  },
+  /**
+   * 获取包裹容器的元素
+   */
+  getWrapperElement,
+  /**
+   * 获取插入到指定容器的元素或字符串
+   */
+  getAppendSelector,
+  /**
+   * 获取插入到指定容器的元素
+   */
+  getAppendElement
+};
 ;// ./packages/src/mixins.ts
 
 
@@ -3817,6 +4081,7 @@ const globalMixins = {
 
 
 
+
 
 
 const installedPlugins = [];
@@ -3893,6 +4158,7 @@ const VxeUI = Object.assign(VxeCore, {
   baseUtils: baseUtils,
   domUtils: domUtils,
   scrollbarUtils: scrollbarUtils,
+  popperUtils: popperUtils,
   globalStore: globalStore,
   component,
   getComponent,
@@ -3923,6 +4189,7 @@ setTheme();
 
 
 
+
 
 
 /* harmony default export */ var packages_0 = (VxeUI);