bkui-vue 2.1.0-dev-beta.13 → 2.1.0-dev-beta.15

package/lib/popover/index.js

@@ -45,7 +45,7 @@ const shared_namespaceObject = x({ ["PlacementEnum"]: () => __WEBPACK_EXTERNAL_M
 ;// CONCATENATED MODULE: external "vue"
 var external_vue_x = y => { var x = {}; __webpack_require__.d(x, y); return x; }
 var external_vue_y = x => () => x
-const external_vue_namespaceObject = external_vue_x({ ["Fragment"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Fragment, ["Teleport"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Teleport, ["computed"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.computed, ["createApp"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createApp, ["createVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createVNode, ["defineComponent"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.defineComponent, ["getCurrentScope"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.getCurrentScope, ["h"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.h, ["isVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.isVNode, ["mergeProps"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.mergeProps, ["nextTick"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.nextTick, ["onBeforeUnmount"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onBeforeUnmount, ["onMounted"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onMounted, ["onScopeDispose"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onScopeDispose, ["reactive"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.reactive, ["ref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.ref, ["shallowReadonly"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowReadonly, ["shallowRef"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowRef, ["toRefs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.toRefs, ["unref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.unref, ["useAttrs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.useAttrs, ["watch"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.watch });
+const external_vue_namespaceObject = external_vue_x({ ["Comment"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Comment, ["Fragment"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Fragment, ["Teleport"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Teleport, ["Text"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.Text, ["cloneVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.cloneVNode, ["computed"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.computed, ["createApp"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createApp, ["createVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.createVNode, ["defineComponent"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.defineComponent, ["getCurrentScope"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.getCurrentScope, ["h"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.h, ["isVNode"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.isVNode, ["mergeProps"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.mergeProps, ["nextTick"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.nextTick, ["onBeforeUnmount"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onBeforeUnmount, ["onMounted"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onMounted, ["onScopeDispose"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.onScopeDispose, ["reactive"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.reactive, ["ref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.ref, ["shallowReadonly"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowReadonly, ["shallowRef"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.shallowRef, ["toRefs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.toRefs, ["unref"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.unref, ["useAttrs"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.useAttrs, ["watch"]: () => __WEBPACK_EXTERNAL_MODULE_vue__.watch });
 ;// CONCATENATED MODULE: ../../node_modules/@babel/runtime/helpers/esm/arrayLikeToArray.js
 function _arrayLikeToArray(r, a) {
   (null == a || a > r.length) && (a = r.length);
@@ -134,7 +134,7 @@ function _defineProperty(e, r, t) {
 ;// CONCATENATED MODULE: external "../config-provider"
 var config_provider_x = y => { var x = {}; __webpack_require__.d(x, y); return x; }
 var config_provider_y = x => () => x
-const config_provider_namespaceObject = config_provider_x({ ["usePrefix"]: () => __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3__.usePrefix });
+const config_provider_namespaceObject = config_provider_x({ ["useGlobalConfig"]: () => __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3__.useGlobalConfig, ["usePrefix"]: () => __WEBPACK_EXTERNAL_MODULE_bkui_vue_lib_config_provider_fe8577a3__.usePrefix });
 ;// CONCATENATED MODULE: ../../node_modules/@babel/runtime/helpers/esm/arrayWithHoles.js
 function _arrayWithHoles(r) {
   if (Array.isArray(r)) return r;
@@ -3190,6 +3190,10 @@ var PopoverProps = {
    * 配置自定义样式类名，传入的类会被加在 Reference 外部的 div 上
    */
   referenceCls: shared_namespaceObject.PropTypes.string.def(''),
+  /**
+   * 是否渲染默认插槽最外层 reference span；仅 true 时主动追加 span
+   */
+  renderReferenceWrapper: shared_namespaceObject.PropTypes.bool.def(undefined),
   /**
    * 点击 Reference 占位区是否忽略收起 popover
    */
@@ -3251,8 +3255,7 @@ function _isSlot(s) {
 var __bkPopoverIdSeed = 0;
 var __bkPopoverRegistry = new Map();
 var findPopoverIdInEventPath = function findPopoverIdInEventPath(event) {
-  var anyEvent = event;
-  var path = typeof anyEvent.composedPath === 'function' ? anyEvent.composedPath() : [];
+  var path = typeof event.composedPath === 'function' ? event.composedPath() : [];
   var _iterator = _createForOfIteratorHelper(path),
     _step;
   try {
@@ -3313,6 +3316,7 @@ var EMIT_EVENTS = {
     var attrs = (0,external_vue_namespaceObject.useAttrs)();
     var _usePrefix = (0,config_provider_namespaceObject.usePrefix)(),
       resolveClassName = _usePrefix.resolveClassName;
+    var globalConfig = (0,config_provider_namespaceObject.useGlobalConfig)();
     // 当前实例 id（用于注册表与事件路径识别）
     var popoverId = "bk-popover-".concat(++__bkPopoverIdSeed);
     // 元素引用
@@ -3357,7 +3361,15 @@ var EMIT_EVENTS = {
       componentEventDelay = _toRefs.componentEventDelay,
       reference = _toRefs.reference,
       target = _toRefs.target,
-      floatingReference = _toRefs.floatingReference;
+      floatingReference = _toRefs.floatingReference,
+      renderReferenceWrapper = _toRefs.renderReferenceWrapper;
+    var shouldRenderReferenceWrapper = (0,external_vue_namespaceObject.computed)(function () {
+      var _renderReferenceWrapp;
+      return ((_renderReferenceWrapp = renderReferenceWrapper.value) !== null && _renderReferenceWrapp !== void 0 ? _renderReferenceWrapp : globalConfig.value.popoverRenderReferenceWrapper) === true;
+    });
+    var setReferenceRef = function setReferenceRef(refValue) {
+      referenceWrapperRef.value = refValue;
+    };
     // 判断是否为虚拟元素
     var isVirtualElement = function isVirtualElement(el) {
       return el !== null && _typeof(el) === 'object' && 'getBoundingClientRect' in el && typeof el.getBoundingClientRect === 'function';
@@ -3377,6 +3389,47 @@ var EMIT_EVENTS = {
       }
       return null;
     };
+    var _resolveElementFromVNode = function resolveElementFromVNode(node) {
+      var _node$component;
+      if (!node) return null;
+      if (node.el instanceof HTMLElement) return node.el;
+      var subTree = (_node$component = node.component) === null || _node$component === void 0 ? void 0 : _node$component.subTree;
+      if (subTree) {
+        var element = _resolveElementFromVNode(subTree);
+        if (element) return element;
+      }
+      if (Array.isArray(node.children)) {
+        var _iterator2 = _createForOfIteratorHelper(node.children),
+          _step2;
+        try {
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var child = _step2.value;
+            if (!(0,external_vue_namespaceObject.isVNode)(child)) continue;
+            var _element = _resolveElementFromVNode(child);
+            if (_element) return _element;
+          }
+        } catch (err) {
+          _iterator2.e(err);
+        } finally {
+          _iterator2.f();
+        }
+      }
+      return null;
+    };
+    var resolveReferenceRefElement = function resolveReferenceRefElement(refValue) {
+      var _instance$$;
+      if (refValue instanceof HTMLElement) {
+        return refValue;
+      }
+      if (!refValue || _typeof(refValue) !== 'object') {
+        return null;
+      }
+      var instance = refValue;
+      if (instance.$el instanceof HTMLElement) {
+        return instance.$el;
+      }
+      return _resolveElementFromVNode((_instance$$ = instance.$) === null || _instance$$ === void 0 ? void 0 : _instance$$.subTree);
+    };
     // 是否使用自定义 reference
     var useCustomReference = (0,external_vue_namespaceObject.computed)(function () {
       return !!reference.value || !!target.value;
@@ -3425,30 +3478,11 @@ var EMIT_EVENTS = {
     /**
      * 解析默认 slot reference 元素
      *
-     * referenceWrapperRef 使用 display: contents，自身无布局尺寸，
-     * 因此需要从子元素中找到实际的 reference 元素。
-     *
-     * 策略：优先使用第一个元素子节点作为 reference；否则向下寻找第一个具有可见尺寸的 HTMLElement。
+     * referenceWrapperRef 在 wrapper 开启时指向外层 span，
+     * wrapper 关闭时指向默认 slot 的实际元素。
      */
     var resolveDefaultReferenceElement = function resolveDefaultReferenceElement() {
-      var wrapper = referenceWrapperRef.value;
-      if (!wrapper) return null;
-      // display: contents 的元素自身尺寸为 0，直接查找子元素
-      var firstChild = wrapper.firstElementChild;
-      if (firstChild instanceof HTMLElement) {
-        return firstChild;
-      }
-      var descendants = wrapper.querySelectorAll('*');
-      for (var _i = 0, _Array$from = Array.from(descendants); _i < _Array$from.length; _i++) {
-        var node = _Array$from[_i];
-        if (!(node instanceof HTMLElement)) continue;
-        var rect = node.getBoundingClientRect();
-        if (rect.width > 0 || rect.height > 0) {
-          return node;
-        }
-      }
-      // 兜底仍返回 wrapper，保证类型与行为一致
-      return wrapper;
+      return resolveReferenceRefElement(referenceWrapperRef.value);
     };
     // 延迟控制
     var delayOptions = (0,external_vue_namespaceObject.computed)(function () {
@@ -3539,8 +3573,8 @@ var EMIT_EVENTS = {
       return target.value;
     }, function () {
       return floatingReference.value;
-    }], function () {
-      return (0,external_vue_namespaceObject.nextTick)(updateFloatingReference);
+    }, shouldRenderReferenceWrapper], function () {
+      (0,external_vue_namespaceObject.nextTick)(updateFloatingReference);
     });
     (0,external_vue_namespaceObject.watch)(isOpen, function (val) {
       if (val) {
@@ -3576,6 +3610,42 @@ var EMIT_EVENTS = {
       }),
       referenceListeners = _useTrigger.referenceListeners,
       floatingListeners = _useTrigger.floatingListeners;
+    var unbindNoWrapperReferenceEvents = [];
+    var clearNoWrapperReferenceEvents = function clearNoWrapperReferenceEvents() {
+      unbindNoWrapperReferenceEvents.forEach(function (unbind) {
+        return unbind();
+      });
+      unbindNoWrapperReferenceEvents = [];
+    };
+    var resolveEventBinding = function resolveEventBinding(eventName) {
+      var rawName = eventName.replace(/^on/, '');
+      var capture = rawName.endsWith('Capture');
+      return {
+        capture: capture,
+        name: rawName.replace(/Capture$/, '').toLowerCase()
+      };
+    };
+    var bindNoWrapperReferenceEvents = function bindNoWrapperReferenceEvents() {
+      clearNoWrapperReferenceEvents();
+      if (shouldRenderReferenceWrapper.value) return;
+      var referenceEl = resolveReferenceRefElement(referenceWrapperRef.value);
+      if (!referenceEl) return;
+      Object.keys(referenceListeners.value).forEach(function (eventName) {
+        var listener = referenceListeners.value[eventName];
+        var eventBinding = resolveEventBinding(eventName);
+        referenceEl.addEventListener(eventBinding.name, listener, eventBinding.capture);
+        unbindNoWrapperReferenceEvents.push(function () {
+          referenceEl.removeEventListener(eventBinding.name, listener, eventBinding.capture);
+        });
+      });
+    };
+    (0,external_vue_namespaceObject.watch)([shouldRenderReferenceWrapper, referenceWrapperRef, function () {
+      return referenceListeners.value;
+    }], function () {
+      (0,external_vue_namespaceObject.nextTick)(bindNoWrapperReferenceEvents);
+    }, {
+      immediate: true
+    });
     // hover 模式：把“子弹层”视为内容区的延伸（避免 PopConfirm 内 Select 下拉导致父弹层收起）
     var hoverTrackMoveHandler = null;
     var stopHoverTrack = function stopHoverTrack() {
@@ -3584,9 +3654,10 @@ var EMIT_EVENTS = {
       hoverTrackMoveHandler = null;
     };
     var isTargetInSelfOrChildren = function isTargetInSelfOrChildren(targetEl) {
-      var _referenceWrapperRef$, _floatingRef$value;
+      var _floatingRef$value;
       var actualRef = floatingReferenceRef.value;
-      if (actualRef instanceof HTMLElement && actualRef.contains(targetEl) || (_referenceWrapperRef$ = referenceWrapperRef.value) !== null && _referenceWrapperRef$ !== void 0 && _referenceWrapperRef$.contains(targetEl)) {
+      var referenceWrapperEl = shouldRenderReferenceWrapper.value ? resolveReferenceRefElement(referenceWrapperRef.value) : null;
+      if (actualRef instanceof HTMLElement && actualRef.contains(targetEl) || referenceWrapperEl instanceof HTMLElement && referenceWrapperEl.contains(targetEl)) {
         return true;
       }
       if ((_floatingRef$value = floatingRef.value) !== null && _floatingRef$value !== void 0 && _floatingRef$value.contains(targetEl)) {
@@ -3698,9 +3769,42 @@ var EMIT_EVENTS = {
     var dataTheme = (0,external_vue_namespaceObject.computed)(function () {
       return theme.value;
     });
+    // 兼容旧版自定义 theme 标记：theme="light bk-table-settings"
+    // 除了追加 bk-table-settings class 外，还需要生成 data-bk-table-settings-theme="true"，
+    // table settings 等组件的弹层样式依赖该属性选择器。
+    var extraThemeAttrs = (0,external_vue_namespaceObject.computed)(function () {
+      var _parseTheme2 = parseTheme(theme.value),
+        extraClasses = _parseTheme2.extraClasses;
+      return extraClasses.reduce(function (attrs, className) {
+        attrs["data-".concat(className, "-theme")] = 'true';
+        return attrs;
+      }, {});
+    });
+    var _filterEmptyNodes = function filterEmptyNodes() {
+      var children = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+      var nodes = [];
+      children.forEach(function (child) {
+        if (!child) {
+          return;
+        }
+        if (Array.isArray(child)) {
+          nodes.push.apply(nodes, _toConsumableArray(_filterEmptyNodes(child)));
+          return;
+        }
+        if (child.type === external_vue_namespaceObject.Fragment && Array.isArray(child.children)) {
+          nodes.push.apply(nodes, _toConsumableArray(_filterEmptyNodes(child.children)));
+          return;
+        }
+        nodes.push(child);
+      });
+      return nodes.filter(function (child) {
+        var _child$children;
+        return !(child && (child.type === external_vue_namespaceObject.Comment || child.type === external_vue_namespaceObject.Fragment && Array.isArray(child.children) && child.children.length === 0 || child.type === external_vue_namespaceObject.Text && "".concat((_child$children = child.children) !== null && _child$children !== void 0 ? _child$children : '').trim() === ''));
+      });
+    };
     // 处理 clickoutside
     var handleClickOutside = function handleClickOutside(event) {
-      var _referenceWrapperRef$2, _floatingRef$value2;
+      var _floatingRef$value2;
       if (disabled.value || always.value) {
         return;
       }
@@ -3711,7 +3815,8 @@ var EMIT_EVENTS = {
       var target = event.target;
       // 点击在 reference 内（包括自定义 reference 和默认 reference）
       var actualRef = floatingReferenceRef.value;
-      var isInReference = actualRef instanceof HTMLElement && actualRef.contains(target) || ((_referenceWrapperRef$2 = referenceWrapperRef.value) === null || _referenceWrapperRef$2 === void 0 ? void 0 : _referenceWrapperRef$2.contains(target));
+      var referenceWrapperEl = shouldRenderReferenceWrapper.value ? resolveReferenceRefElement(referenceWrapperRef.value) : null;
+      var isInReference = actualRef instanceof HTMLElement && actualRef.contains(target) || referenceWrapperEl instanceof HTMLElement && referenceWrapperEl.contains(target);
       if (isInReference) {
         // 对于 click 和 hover 模式，点击 reference 的行为由 referenceListeners 处理
         if (trigger.value === 'click' || trigger.value === 'hover') {
@@ -3781,38 +3886,35 @@ var EMIT_EVENTS = {
       }
       return isOpen.value;
     });
-    // 为自定义 reference 元素添加事件监听（仅对 HTMLElement 有效，虚拟元素不绑定事件）
-    var bindCustomReferenceEvents = function bindCustomReferenceEvents() {
-      if (!useCustomReference.value || isVirtualReferenceMode.value) return;
-      var customRef = getActualReferenceElement();
-      if (!customRef) return;
-      var listeners = referenceListeners.value;
-      Object.keys(listeners).forEach(function (eventName) {
-        // 将 onMouseenter 转换为 mouseenter
-        var nativeEventName = eventName.replace(/^on/, '').toLowerCase();
-        customRef.addEventListener(nativeEventName, listeners[eventName]);
+    var unbindCustomReferenceEvents = [];
+    var clearCustomReferenceEvents = function clearCustomReferenceEvents() {
+      unbindCustomReferenceEvents.forEach(function (unbind) {
+        return unbind();
       });
+      unbindCustomReferenceEvents = [];
     };
-    var unbindCustomReferenceEvents = function unbindCustomReferenceEvents() {
+    var bindCustomReferenceEvents = function bindCustomReferenceEvents() {
+      clearCustomReferenceEvents();
       if (!useCustomReference.value || isVirtualReferenceMode.value) return;
       var customRef = getActualReferenceElement();
       if (!customRef) return;
-      var listeners = referenceListeners.value;
-      Object.keys(listeners).forEach(function (eventName) {
-        var nativeEventName = eventName.replace(/^on/, '').toLowerCase();
-        customRef.removeEventListener(nativeEventName, listeners[eventName]);
+      Object.keys(referenceListeners.value).forEach(function (eventName) {
+        var listener = referenceListeners.value[eventName];
+        var eventBinding = resolveEventBinding(eventName);
+        customRef.addEventListener(eventBinding.name, listener, eventBinding.capture);
+        unbindCustomReferenceEvents.push(function () {
+          customRef.removeEventListener(eventBinding.name, listener, eventBinding.capture);
+        });
       });
     };
-    // 监听自定义 reference 变化
     (0,external_vue_namespaceObject.watch)([function () {
       return reference.value;
     }, function () {
       return target.value;
+    }, function () {
+      return referenceListeners.value;
     }], function () {
-      unbindCustomReferenceEvents();
-      (0,external_vue_namespaceObject.nextTick)(function () {
-        bindCustomReferenceEvents();
-      });
+      (0,external_vue_namespaceObject.nextTick)(bindCustomReferenceEvents);
     });
     // 挂载时添加 clickoutside 监听
     (0,external_vue_namespaceObject.onMounted)(function () {
@@ -3829,7 +3931,8 @@ var EMIT_EVENTS = {
     // 卸载时清理
     (0,external_vue_namespaceObject.onBeforeUnmount)(function () {
       document.removeEventListener('click', handleClickOutside, true);
-      unbindCustomReferenceEvents();
+      clearCustomReferenceEvents();
+      clearNoWrapperReferenceEvents();
       clearTimers();
       if (eventDelayTimer) {
         clearTimeout(eventDelayTimer);
@@ -3848,7 +3951,7 @@ var EMIT_EVENTS = {
         id: popoverId,
         floatingEl: floatingRef.value,
         referenceEl: referenceEl,
-        referenceWrapperEl: referenceWrapperRef.value
+        referenceWrapperEl: shouldRenderReferenceWrapper.value ? resolveReferenceRefElement(referenceWrapperRef.value) : null
       });
     };
     (0,external_vue_namespaceObject.watch)([floatingRef, floatingReferenceRef, referenceWrapperRef], function () {
@@ -3900,7 +4003,7 @@ var EMIT_EVENTS = {
       return boundaryVal instanceof HTMLElement ? boundaryVal : 'body';
     });
     return function () {
-      var _slots$arrow, _slots$content, _slots$content2, _slots$default;
+      var _slots$arrow, _slots$content, _slots$content2, _slots$default, _slots$default2;
       // 渲染 floating content
       var floatingNode = shouldRenderContent.value ? (0,external_vue_namespaceObject.createVNode)("div", (0,external_vue_namespaceObject.mergeProps)({
         "ref": floatingRef,
@@ -3908,9 +4011,10 @@ var EMIT_EVENTS = {
           pointerEvents: contentPointerEvents.value
         }),
         "class": contentClass.value,
-        "data-bk-popover-id": popoverId,
-        "data-theme": dataTheme.value,
         "data-arrow": arrowSide.value,
+        "data-bk-popover-id": popoverId,
+        "data-theme": dataTheme.value
+      }, extraThemeAttrs.value, {
         "onClick": handleClickContent
       }, guardedFloatingListeners.value), [arrow.value && (0,external_vue_namespaceObject.createVNode)("div", {
         "ref": arrowRef,
@@ -3918,8 +4022,7 @@ var EMIT_EVENTS = {
         "class": resolveClassName('pop2-arrow'),
         "data-arrow": arrowSide.value
       }, [(_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;
-      // 如果使用自定义 reference（虚拟元素或外部 HTMLElement），只渲染 Teleport 内容
-      if (useCustomReference.value) {
+      var renderTeleport = function renderTeleport() {
         return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Teleport, {
           "disabled": disableTeleport.value,
           "to": teleportTo.value
@@ -3928,25 +4031,59 @@ var EMIT_EVENTS = {
             return [floatingNode];
           }
         });
+      };
+      // 如果使用自定义 reference（虚拟元素或外部 HTMLElement），只渲染 Teleport 内容
+      if (useCustomReference.value) {
+        return renderTeleport();
       }
-      // 默认情况：渲染 reference 和 floating content
-      // 使用 display: contents 避免影响内部元素布局
-      return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Fragment, null, [(0,external_vue_namespaceObject.createVNode)("span", (0,external_vue_namespaceObject.mergeProps)({
-        "ref": referenceWrapperRef,
-        "style": {
-          display: 'contents',
-          width: '100%',
-          height: '100%'
-        },
-        "class": [referenceCls.value, attrs["class"]]
-      }, referenceListeners.value), [(_slots$default = slots["default"]) === null || _slots$default === void 0 ? void 0 : _slots$default.call(slots)]), (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Teleport, {
-        "disabled": disableTeleport.value,
-        "to": teleportTo.value
-      }, _isSlot(floatingNode) ? floatingNode : {
-        "default": function _default() {
-          return [floatingNode];
+      var defaultSlotNodes = (_slots$default = (_slots$default2 = slots["default"]) === null || _slots$default2 === void 0 ? void 0 : _slots$default2.call(slots)) !== null && _slots$default !== void 0 ? _slots$default : [];
+      var referenceNodes = _filterEmptyNodes(defaultSlotNodes);
+      if (shouldRenderReferenceWrapper.value) {
+        return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Fragment, null, [(0,external_vue_namespaceObject.createVNode)("span", (0,external_vue_namespaceObject.mergeProps)({
+          "ref": referenceWrapperRef,
+          "style": {
+            display: 'inline-block'
+          },
+          "class": [referenceCls.value, attrs["class"]]
+        }, referenceListeners.value), [defaultSlotNodes]), renderTeleport()]);
+      }
+      var renderReferenceNode = function renderReferenceNode() {
+        if (!referenceNodes.length) {
+          return null;
+        }
+        // 默认无包裹模式：保持 Fragment 根结构，不主动追加任何具体 DOM。
+        // 为了兼容定位与触发事件，尽可能把 ref/class 透传到第一个非文本 reference 节点。
+        // 但纯文本 slot 没有可承载 ref 和监听器的 DOM 节点，需要生成一个 span 作为触发元素。
+        var isTextReference = referenceNodes.every(function (node) {
+          return (0,external_vue_namespaceObject.isVNode)(node) && node.type === external_vue_namespaceObject.Text;
+        });
+        if (isTextReference) {
+          return (0,external_vue_namespaceObject.createVNode)("span", {
+            "ref": referenceWrapperRef,
+            "style": {
+              display: 'inline-block'
+            },
+            "class": [referenceCls.value, attrs["class"]]
+          }, [referenceNodes]);
+        }
+        var referenceNodeIndex = referenceNodes.findIndex(function (node) {
+          return (0,external_vue_namespaceObject.isVNode)(node) && node.type !== external_vue_namespaceObject.Text && node.type !== external_vue_namespaceObject.Comment;
+        });
+        if (referenceNodeIndex < 0) {
+          return referenceNodes;
         }
-      })]);
+        return referenceNodes.map(function (node, index) {
+          if (index !== referenceNodeIndex || !(0,external_vue_namespaceObject.isVNode)(node)) {
+            return node;
+          }
+          return (0,external_vue_namespaceObject.cloneVNode)(node, {
+            ref: setReferenceRef,
+            "class": [referenceCls.value, attrs["class"]]
+          }, true);
+        });
+      };
+      // 默认情况：渲染 reference 和 floating content
+      return (0,external_vue_namespaceObject.createVNode)(external_vue_namespaceObject.Fragment, null, [renderReferenceNode(), renderTeleport()]);
     };
   }
 }));

package/lib/popover/popover.d.ts

@@ -131,6 +131,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     } & {
         default: string;
     };
+    renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
     hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
         default: boolean;
     } & {
@@ -279,6 +284,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     } & {
         default: string;
     };
+    renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
     hideIgnoreReference: import("vue-types").VueTypeValidableDef<boolean> & {
         default: boolean;
     } & {
@@ -335,6 +345,7 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     popoverDelay: number | number[];
     extCls: string;
     referenceCls: string;
+    renderReferenceWrapper: boolean;
     hideIgnoreReference: boolean;
     componentEventDelay: number;
     forceClickoutside: boolean;

package/lib/popover/props.d.ts

@@ -180,6 +180,14 @@ export declare const PopoverProps: {
     } & {
         default: string;
     };
+    /**
+     * 是否渲染默认插槽最外层 reference span；仅 true 时主动追加 span
+     */
+    renderReferenceWrapper: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
     /**
      * 点击 Reference 占位区是否忽略收起 popover
      */

package/lib/preset.d.ts

@@ -139,6 +139,10 @@ declare const _default: {
                 };
             }>;
         };
+        popoverRenderReferenceWrapper: {
+            type: import("vue").PropType<boolean>;
+            default: any;
+        };
         prefix: {
             type: StringConstructor;
             default: string;
@@ -283,6 +287,10 @@ declare const _default: {
                 };
             }>;
         };
+        popoverRenderReferenceWrapper: {
+            type: import("vue").PropType<boolean>;
+            default: any;
+        };
         prefix: {
             type: StringConstructor;
             default: string;