bkui-vue 3.0.8 → 3.0.9

package/lib/dropdown/index.js

@@ -152,7 +152,9 @@ function _defineProperty(e, r, t) {
       arrow: false,
       placement: this.placement,
       isShow: this.isShow,
-      disabled: this.disabled
+      disabled: this.disabled,
+      // 点击菜单项后收起，避免随后打开的 Dialog 被 Dropdown（更高 z-index）挡住
+      clickContentAutoHide: true
     };
     var popoverOptions = __WEBPACK_EXTERNAL_MODULE_lodash_merge_cf99375a_default__(basePopoverOptions, this.popoverOptions);
     return __WEBPACK_EXTERNAL_MODULE_vue_createVNode__("div", {

package/lib/index.js

@@ -3,5 +3,5 @@ export * from './hooks';
 export { default } from './preset';
 export * from './config-provider';
 export * from './directives';
-export const version = "3.0.8";
+export const version = "3.0.9";
 window.__bkui_vue_version__ = version;

package/lib/modal/index.js

@@ -1,6 +1,6 @@
 import "../styles/reset.css";
 import "./modal.less";
-import { PropTypes as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_PropTypes__, bkZIndexManager as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_bkZIndexManager__, renderDirectiveType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_renderDirectiveType__, withInstallProps as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_withInstallProps__ } from "../shared";
+import { PropTypes as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_PropTypes__, bkZIndexManager as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_bkZIndexManager__, hidePopoversOutside as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_hidePopoversOutside__, renderDirectiveType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_renderDirectiveType__, withInstallProps as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_withInstallProps__ } from "../shared";
 import { Teleport as __WEBPACK_EXTERNAL_MODULE_vue_Teleport__, Transition as __WEBPACK_EXTERNAL_MODULE_vue_Transition__, computed as __WEBPACK_EXTERNAL_MODULE_vue_computed__, createVNode as __WEBPACK_EXTERNAL_MODULE_vue_createVNode__, defineComponent as __WEBPACK_EXTERNAL_MODULE_vue_defineComponent__, mergeProps as __WEBPACK_EXTERNAL_MODULE_vue_mergeProps__, onBeforeUnmount as __WEBPACK_EXTERNAL_MODULE_vue_onBeforeUnmount__, onMounted as __WEBPACK_EXTERNAL_MODULE_vue_onMounted__, ref as __WEBPACK_EXTERNAL_MODULE_vue_ref__, useAttrs as __WEBPACK_EXTERNAL_MODULE_vue_useAttrs__, useSlots as __WEBPACK_EXTERNAL_MODULE_vue_useSlots__, vShow as __WEBPACK_EXTERNAL_MODULE_vue_vShow__, watch as __WEBPACK_EXTERNAL_MODULE_vue_watch__, withDirectives as __WEBPACK_EXTERNAL_MODULE_vue_withDirectives__ } from "vue";
 import { usePrefix as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3_usePrefix__ } from "../config-provider";
 import { default as __WEBPACK_EXTERNAL_MODULE_lodash_throttle_a7b7506a_default__ } from "lodash/throttle";
@@ -339,6 +339,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
     var localShow = __WEBPACK_EXTERNAL_MODULE_vue_ref__(props.isShow);
     var zIndex = __WEBPACK_EXTERNAL_MODULE_vue_ref__(props.zIndex);
     var initRendered = __WEBPACK_EXTERNAL_MODULE_vue_ref__(false);
+    var showTimer;
     var _useContentResize = useContentResize(rootRef, resizeTargetRef, props),
       contentStyles = _useContentResize.contentStyles,
       isContentScroll = _useContentResize.isContentScroll;
@@ -362,13 +363,22 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
     }, function () {
       if (props.isShow) {
         initRendered.value = true;
-        setTimeout(function () {
+        showTimer = setTimeout(function () {
+          showTimer = undefined;
           zIndex.value = props.zIndex || __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_bkZIndexManager__.getModalNextIndex();
           props.showMask && mask.showMask(maskRef.value);
           ctx.emit('shown');
           localShow.value = true;
+          // Dropdown / Popover 默认层级高于 Modal，先收起页面上未挂在当前弹窗内的弹出层
+          if (rootRef.value) {
+            __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_hidePopoversOutside__(rootRef.value);
+          }
         });
       } else if (initRendered.value) {
+        if (showTimer !== undefined) {
+          clearTimeout(showTimer);
+          showTimer = undefined;
+        }
         props.showMask && mask.hideMask(maskRef.value);
         ctx.emit('hidden');
         localShow.value = false;
@@ -403,6 +413,10 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
       addEventListener('keydown', handleEscClose);
     });
     __WEBPACK_EXTERNAL_MODULE_vue_onBeforeUnmount__(function () {
+      if (showTimer !== undefined) {
+        clearTimeout(showTimer);
+        showTimer = undefined;
+      }
       removeEventListener('keydown', handleEscClose);
       mask.destroyMask(maskRef.value);
       ctx.emit('hidden');

package/lib/popover/index.js

@@ -1,6 +1,6 @@
 import "../styles/reset.css";
 import "./popover.less";
-import { PlacementEnum as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_PlacementEnum__, PropTypes as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_PropTypes__, RenderType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_RenderType__, bkZIndexManager as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_bkZIndexManager__, placementType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_placementType__, renderDirectiveType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_renderDirectiveType__, renderType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_renderType__, triggerType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_triggerType__, withInstall as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_withInstall__ } from "../shared";
+import { PlacementEnum as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_PlacementEnum__, PropTypes as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_PropTypes__, RenderType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_RenderType__, bkZIndexManager as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_bkZIndexManager__, placementType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_placementType__, registerPopoverOverlay as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_registerPopoverOverlay__, renderDirectiveType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_renderDirectiveType__, renderType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_renderType__, triggerType as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_triggerType__, withInstall as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_withInstall__ } from "../shared";
 import { Comment as __WEBPACK_EXTERNAL_MODULE_vue_Comment__, Fragment as __WEBPACK_EXTERNAL_MODULE_vue_Fragment__, Teleport as __WEBPACK_EXTERNAL_MODULE_vue_Teleport__, Text as __WEBPACK_EXTERNAL_MODULE_vue_Text__, cloneVNode as __WEBPACK_EXTERNAL_MODULE_vue_cloneVNode__, computed as __WEBPACK_EXTERNAL_MODULE_vue_computed__, createApp as __WEBPACK_EXTERNAL_MODULE_vue_createApp__, createVNode as __WEBPACK_EXTERNAL_MODULE_vue_createVNode__, defineComponent as __WEBPACK_EXTERNAL_MODULE_vue_defineComponent__, getCurrentScope as __WEBPACK_EXTERNAL_MODULE_vue_getCurrentScope__, h as __WEBPACK_EXTERNAL_MODULE_vue_h__, isVNode as __WEBPACK_EXTERNAL_MODULE_vue_isVNode__, mergeProps as __WEBPACK_EXTERNAL_MODULE_vue_mergeProps__, nextTick as __WEBPACK_EXTERNAL_MODULE_vue_nextTick__, onBeforeUnmount as __WEBPACK_EXTERNAL_MODULE_vue_onBeforeUnmount__, onMounted as __WEBPACK_EXTERNAL_MODULE_vue_onMounted__, onScopeDispose as __WEBPACK_EXTERNAL_MODULE_vue_onScopeDispose__, reactive as __WEBPACK_EXTERNAL_MODULE_vue_reactive__, ref as __WEBPACK_EXTERNAL_MODULE_vue_ref__, shallowReadonly as __WEBPACK_EXTERNAL_MODULE_vue_shallowReadonly__, shallowRef as __WEBPACK_EXTERNAL_MODULE_vue_shallowRef__, toRefs as __WEBPACK_EXTERNAL_MODULE_vue_toRefs__, unref as __WEBPACK_EXTERNAL_MODULE_vue_unref__, useAttrs as __WEBPACK_EXTERNAL_MODULE_vue_useAttrs__, watch as __WEBPACK_EXTERNAL_MODULE_vue_watch__ } from "vue";
 import { useGlobalConfig as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3_useGlobalConfig__, usePrefix as __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3_usePrefix__ } from "../config-provider";
 import { toType as __WEBPACK_EXTERNAL_MODULE_vue_types_22de060a_toType__ } from "vue-types";
@@ -3481,7 +3481,7 @@ var EMIT_EVENTS = {
           }
         }
       }),
-      isOpen = _useDelay.isOpen,
+      _isOpen = _useDelay.isOpen,
       show = _useDelay.show,
       hide = _useDelay.hide,
       toggle = _useDelay.toggle,
@@ -3491,11 +3491,18 @@ var EMIT_EVENTS = {
       var b = boundary.value;
       return typeof b === 'function' ? b() : b;
     };
+    var isParentBoundary = __WEBPACK_EXTERNAL_MODULE_vue_computed__(function () {
+      var b = resolveBoundary();
+      return typeof b === 'string' && /^parent$/i.test(b);
+    });
+    var isTeleportDisabled = __WEBPACK_EXTERNAL_MODULE_vue_computed__(function () {
+      return disableTeleport.value || isParentBoundary.value;
+    });
     var floatingStrategy = __WEBPACK_EXTERNAL_MODULE_vue_computed__(function () {
-      if (disableTeleport.value) return 'absolute';
+      if (isTeleportDisabled.value) return 'absolute';
       var b = resolveBoundary();
       if (typeof b === 'string') {
-        return b === 'body' || b === 'parent' ? 'fixed' : 'absolute';
+        return /^body$/i.test(b) ? 'fixed' : 'absolute';
       }
       if (b === document.body) return 'fixed';
       return 'absolute';
@@ -3511,7 +3518,7 @@ var EMIT_EVENTS = {
         autoVisibility: autoVisibility.value,
         disableTransform: disableTransform.value,
         strategy: floatingStrategy.value,
-        isOpen: isOpen.value
+        isOpen: _isOpen.value
       };
     });
     // 更新 floating-ui 定位 reference（避免 computed 缓存导致 DOM 布局变化时 reference 解析不生效）
@@ -3548,7 +3555,7 @@ var EMIT_EVENTS = {
     }, shouldRenderReferenceWrapper], function () {
       __WEBPACK_EXTERNAL_MODULE_vue_nextTick__(updateFloatingReference);
     });
-    __WEBPACK_EXTERNAL_MODULE_vue_watch__(isOpen, function (val) {
+    __WEBPACK_EXTERNAL_MODULE_vue_watch__(_isOpen, function (val) {
       if (val) {
         __WEBPACK_EXTERNAL_MODULE_vue_nextTick__(updateFloatingReference);
       }
@@ -3565,7 +3572,7 @@ var EMIT_EVENTS = {
         disabled: disabled.value,
         always: always.value,
         hideIgnoreReference: hideIgnoreReference.value,
-        isOpen: isOpen.value
+        isOpen: _isOpen.value
       };
     });
     var _useTrigger = useTrigger(triggerProps, {
@@ -3652,7 +3659,7 @@ var EMIT_EVENTS = {
         if (!(t instanceof HTMLElement)) return;
         if (isTargetInSelfOrChildren(t)) return;
         stopHoverTrack();
-        if (isOpen.value) {
+        if (_isOpen.value) {
           hide();
         }
       };
@@ -3697,6 +3704,25 @@ var EMIT_EVENTS = {
       }
       return String(val);
     };
+    // 打开时固定 z-index，避免 computed 重复递增把已展开的 Dropdown 再次抬到 Dialog 之上
+    var localZIndex = __WEBPACK_EXTERNAL_MODULE_vue_ref__(undefined);
+    var assignZIndex = function assignZIndex() {
+      var _zIndex$value;
+      localZIndex.value = (_zIndex$value = zIndex.value) !== null && _zIndex$value !== void 0 ? _zIndex$value : __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_bkZIndexManager__.getPopperIndex();
+    };
+    __WEBPACK_EXTERNAL_MODULE_vue_watch__(_isOpen, function (val) {
+      if (val) {
+        assignZIndex();
+      }
+    }, {
+      immediate: true,
+      flush: 'sync'
+    });
+    __WEBPACK_EXTERNAL_MODULE_vue_watch__(zIndex, function (val) {
+      if (_isOpen.value && val !== undefined) {
+        localZIndex.value = val;
+      }
+    });
     // 内容样式
     var contentStyles = __WEBPACK_EXTERNAL_MODULE_vue_computed__(function () {
       var styles = popover_objectSpread(popover_objectSpread({}, floatingStyles.value), {}, {
@@ -3706,12 +3732,11 @@ var EMIT_EVENTS = {
         maxHeight: maxHeight.value !== 'auto' ? resolvePixelValue(maxHeight.value) : undefined
       });
       // 设置 z-index
-      if (isOpen.value) {
-        var _zIndex$value;
-        styles.zIndex = (_zIndex$value = zIndex.value) !== null && _zIndex$value !== void 0 ? _zIndex$value : __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_bkZIndexManager__.getPopperIndex();
+      if (_isOpen.value) {
+        styles.zIndex = localZIndex.value;
       }
       // 隐藏时设置 display: none
-      if (!isOpen.value && renderDirective.value === 'show') {
+      if (!_isOpen.value && renderDirective.value === 'show') {
         styles.display = 'none';
       }
       return styles;
@@ -3732,7 +3757,7 @@ var EMIT_EVENTS = {
       var _parseTheme = parseTheme(theme.value),
         extraClasses = _parseTheme.extraClasses;
       var classes = [resolveClassName('popover'), resolveClassName('pop2-content'), extCls.value].concat(_toConsumableArray(extraClasses));
-      if (!isOpen.value) {
+      if (!_isOpen.value) {
         classes.push('hidden');
       }
       return classes.filter(Boolean);
@@ -3805,7 +3830,7 @@ var EMIT_EVENTS = {
       }
       // 触发 clickoutside 事件（让调用者决定如何处理）
       emit(EMIT_EVENTS.CLICK_OUTSIDE, {
-        isShow: isOpen.value,
+        isShow: _isOpen.value,
         event: event
       });
       // 决定是否自动隐藏 popover
@@ -3818,7 +3843,7 @@ var EMIT_EVENTS = {
         return;
       }
       // 隐藏 popover
-      if (isOpen.value) {
+      if (_isOpen.value) {
         hide();
       }
     };
@@ -3831,7 +3856,7 @@ var EMIT_EVENTS = {
     // 处理 componentEventDelay
     var contentPointerEvents = __WEBPACK_EXTERNAL_MODULE_vue_ref__('auto');
     var eventDelayTimer;
-    __WEBPACK_EXTERNAL_MODULE_vue_watch__(isOpen, function (newVal) {
+    __WEBPACK_EXTERNAL_MODULE_vue_watch__(_isOpen, function (newVal) {
       if (newVal && componentEventDelay.value > 0) {
         contentPointerEvents.value = 'none';
         eventDelayTimer = setTimeout(function () {
@@ -3856,7 +3881,7 @@ var EMIT_EVENTS = {
       if (renderType.value === __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_RenderType__.AUTO) {
         return true;
       }
-      return isOpen.value;
+      return _isOpen.value;
     });
     var unbindCustomReferenceEvents = [];
     var clearCustomReferenceEvents = function clearCustomReferenceEvents() {
@@ -3900,6 +3925,29 @@ var EMIT_EVENTS = {
         });
       }
     });
+    var unregisterPopoverOverlay = __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_shared_edbdfb03_registerPopoverOverlay__({
+      hide: function hide() {
+        if (always.value) {
+          return;
+        }
+        clearTimers();
+        if (_isOpen.value) {
+          _isOpen.value = false;
+        }
+      },
+      isOpen: function isOpen() {
+        return _isOpen.value;
+      },
+      isAlways: function isAlways() {
+        return always.value;
+      },
+      getReferenceEl: function getReferenceEl() {
+        return getActualReferenceElement() || resolveDefaultReferenceElement() || resolveReferenceRefElement(referenceWrapperRef.value);
+      },
+      getFloatingEl: function getFloatingEl() {
+        return floatingRef.value;
+      }
+    });
     // 卸载时清理
     __WEBPACK_EXTERNAL_MODULE_vue_onBeforeUnmount__(function () {
       document.removeEventListener('click', handleClickOutside, true);
@@ -3910,6 +3958,7 @@ var EMIT_EVENTS = {
         clearTimeout(eventDelayTimer);
       }
       bkPopoverRegistry["delete"](popoverId);
+      unregisterPopoverOverlay();
       stopHoverTrack();
     });
     // 注册到全局表（用于父子弹层交互判定）
@@ -3941,7 +3990,7 @@ var EMIT_EVENTS = {
     };
     var resetPopover = function resetPopover() {
       clearTimers();
-      isOpen.value = false;
+      _isOpen.value = false;
       __WEBPACK_EXTERNAL_MODULE_vue_nextTick__(function () {
         update();
       });
@@ -3953,13 +4002,13 @@ var EMIT_EVENTS = {
       resetPopover: resetPopover,
       stopHide: stopHide,
       handleClickOutside: handleClickOutside,
-      isOpen: isOpen,
-      localIsShow: isOpen // 兼容旧 API
+      isOpen: _isOpen,
+      localIsShow: _isOpen // 兼容旧 API
     });
     var teleportTo = __WEBPACK_EXTERNAL_MODULE_vue_computed__(function () {
       var boundaryVal = resolveBoundary();
       if (typeof boundaryVal === 'string') {
-        if (boundaryVal === 'body' || boundaryVal === 'parent') {
+        if (/^body$/i.test(boundaryVal) || isParentBoundary.value) {
           return 'body';
         }
         try {
@@ -3996,7 +4045,7 @@ var EMIT_EVENTS = {
       }, [(_slots$arrow = slots.arrow) === null || _slots$arrow === void 0 ? void 0 : _slots$arrow.call(slots)]), (_slots$content = (_slots$content2 = slots.content) === null || _slots$content2 === void 0 ? void 0 : _slots$content2.call(slots)) !== null && _slots$content !== void 0 ? _slots$content : renderContent()]) : null;
       var renderTeleport = function renderTeleport() {
         return __WEBPACK_EXTERNAL_MODULE_vue_createVNode__(__WEBPACK_EXTERNAL_MODULE_vue_Teleport__, {
-          "disabled": disableTeleport.value,
+          "disabled": isTeleportDisabled.value,
           "to": teleportTo.value
         }, _isSlot(floatingNode) ? floatingNode : {
           "default": function _default() {

package/lib/shared/index.d.ts

@@ -30,6 +30,7 @@ export * from './helper';
 export * from './hooks/use-form';
 export * from './hooks/use-form-item';
 export * from './popover';
+export * from './popover-overlay';
 export * from './scrollbar-width';
 export * from './token';
 export * from './utils';

package/lib/shared/index.js

@@ -1102,6 +1102,75 @@ var getPopContainerId = function getPopContainerId() {
   }
   return "".concat(prefix).concat(popContainerId);
 };
+;// ../../packages/shared/src/popover-overlay.ts
+/**
+ * Tencent is pleased to support the open source community by making
+ * 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition) available.
+ *
+ * Copyright (C) 2025 Tencent.  All rights reserved.
+ *
+ * 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition) is licensed under the MIT License.
+ *
+ * License for 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition):
+ *
+ * ---------------------------------------------------
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+ * documentation files (the "Software"), to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
+ * to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of
+ * the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+ * THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+ * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+ * IN THE SOFTWARE.
+ */
+var popoverOverlayInstances = new Set();
+/**
+ * 注册 Popover / Dropdown 等弹出层，供 Modal 打开时收起页面上无关的弹层。
+ */
+var registerPopoverOverlay = function registerPopoverOverlay(instance) {
+  popoverOverlayInstances.add(instance);
+  return function () {
+    popoverOverlayInstances["delete"](instance);
+  };
+};
+var isInsideContainer = function isInsideContainer(instance, container) {
+  var referenceEl = instance.getReferenceEl();
+  if (referenceEl && container.contains(referenceEl)) {
+    return true;
+  }
+  var floatingEl = instance.getFloatingEl();
+  return !!(floatingEl && container.contains(floatingEl));
+};
+/**
+ * 收起不在指定容器内的弹出层。
+ *
+ * Popover 默认 z-index（~8000）高于 Dialog/Modal（~2000），
+ * 页面上已展开的 Dropdown 会盖住后打开的 Dialog。
+ * Dialog 内的 Select / DatePicker 等弹层（reference 在容器内）需要保留。
+ */
+var hidePopoversOutside = function hidePopoversOutside(container) {
+  if (!container) {
+    return;
+  }
+  popoverOverlayInstances.forEach(function (instance) {
+    var _instance$isAlways;
+    if ((_instance$isAlways = instance.isAlways) !== null && _instance$isAlways !== void 0 && _instance$isAlways.call(instance)) {
+      return;
+    }
+    if (!instance.isOpen()) {
+      return;
+    }
+    if (isInsideContainer(instance, container)) {
+      return;
+    }
+    instance.hide();
+  });
+};
 ;// ../../packages/shared/src/scrollbar-width.ts
 /*
  * Tencent is pleased to support the open source community by making
@@ -1817,6 +1886,7 @@ var bkZIndexManager = new BKZIndexManager();
 
 
 
+
 function classes(dynamicCls) {
   var constCls = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
   return Object.entries(dynamicCls).filter(function (entry) {
@@ -1939,4 +2009,4 @@ function arrayEqual() {
   }
   return true;
 }
-export { AlignEnum, BKLAYERD_INDEX_EFAULT_VALUE, BKLAYERTYPE, BKPopover, DialogTypeEnum, DirectionEnum, EMPTY_OBJ, InputBehaviorEnum, InputBehaviorType, LineStyleEnum, PlacementEnum, Placements, ProgressEnum, ProgressStrokeLineCapEnum, ProgressStrokeLineCapType, ProgressType, PropTypes, RenderDirectiveEnum, RenderType, SelectedType, SelectedTypeEnum, SizeEnum, SwitcherThemeEnum, SwitcherThemeType, TagThemeEnum, TagThemeType, ThemeEnum, TimelineNodeTypeEnum, TriggerEnum, alignType, arrayEqual, bkZIndexManager, capitalize, checkOverflow, classes, clone, debounce, dialogTypeUnion, directionType, elementsEqual, filterProperty, finiteOrDefault, formItemKey, formKey, _getFullscreenRoot as getFullscreenRoot, getPopContainerId, hasOverflowEllipsis, isArray, helper_isElement as isElement, isEmpty, isEmptyObj, isNumberFinite as isFinite, isFullScreenContainsElement, isFunction, isNullOrUndef, isObject, isPromise, isString, isSymbol, lineStyleType, maybeShowTooltip, merge, mergeIf, mergerFn, mergerIfFn, noop, observerResize, off, on, placementType, random, renderDirectiveType, renderEmptyVNode, renderType, resolveClassName, scrollTop, scrollbarWidth, stringEnum, throttle, triggerType, useForm, useFormItem, valueOrDefault, withInstall, withInstallProps };
+export { AlignEnum, BKLAYERD_INDEX_EFAULT_VALUE, BKLAYERTYPE, BKPopover, DialogTypeEnum, DirectionEnum, EMPTY_OBJ, InputBehaviorEnum, InputBehaviorType, LineStyleEnum, PlacementEnum, Placements, ProgressEnum, ProgressStrokeLineCapEnum, ProgressStrokeLineCapType, ProgressType, PropTypes, RenderDirectiveEnum, RenderType, SelectedType, SelectedTypeEnum, SizeEnum, SwitcherThemeEnum, SwitcherThemeType, TagThemeEnum, TagThemeType, ThemeEnum, TimelineNodeTypeEnum, TriggerEnum, alignType, arrayEqual, bkZIndexManager, capitalize, checkOverflow, classes, clone, debounce, dialogTypeUnion, directionType, elementsEqual, filterProperty, finiteOrDefault, formItemKey, formKey, _getFullscreenRoot as getFullscreenRoot, getPopContainerId, hasOverflowEllipsis, hidePopoversOutside, isArray, helper_isElement as isElement, isEmpty, isEmptyObj, isNumberFinite as isFinite, isFullScreenContainsElement, isFunction, isNullOrUndef, isObject, isPromise, isString, isSymbol, lineStyleType, maybeShowTooltip, merge, mergeIf, mergerFn, mergerIfFn, noop, observerResize, off, on, placementType, random, registerPopoverOverlay, renderDirectiveType, renderEmptyVNode, renderType, resolveClassName, scrollTop, scrollbarWidth, stringEnum, throttle, triggerType, useForm, useFormItem, valueOrDefault, withInstall, withInstallProps };

package/lib/shared/popover-overlay.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tencent is pleased to support the open source community by making
+ * 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition) available.
+ *
+ * Copyright (C) 2025 Tencent.  All rights reserved.
+ *
+ * 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition) is licensed under the MIT License.
+ *
+ * License for 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition):
+ *
+ * ---------------------------------------------------
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+ * documentation files (the "Software"), to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
+ * to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of
+ * the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+ * THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+ * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+ * IN THE SOFTWARE.
+ */
+export type PopoverOverlayInstance = {
+    hide: () => void;
+    isOpen: () => boolean;
+    isAlways?: () => boolean;
+    getReferenceEl: () => HTMLElement | null;
+    getFloatingEl: () => HTMLElement | null;
+};
+/**
+ * 注册 Popover / Dropdown 等弹出层，供 Modal 打开时收起页面上无关的弹层。
+ */
+export declare const registerPopoverOverlay: (instance: PopoverOverlayInstance) => () => void;
+/**
+ * 收起不在指定容器内的弹出层。
+ *
+ * Popover 默认 z-index（~8000）高于 Dialog/Modal（~2000），
+ * 页面上已展开的 Dropdown 会盖住后打开的 Dialog。
+ * Dialog 内的 Select / DatePicker 等弹层（reference 在容器内）需要保留。
+ */
+export declare const hidePopoversOutside: (container?: HTMLElement | null) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bkui-vue",
-  "version": "3.0.8",
+  "version": "3.0.9",
   "workspaces": [
     "packages/**",
     "scripts/cli",