Skip to content

Popover 弹出层

轻量级弹出层组件,用于鼠标悬浮时显示额外内容(如菜单、选项卡片),支持自动位置翻转和交互停留。

基础用法

语言切换示例

触发方式

组件默认通过 hover 触发,鼠标移入触发区域或内容区域时显示,移出后延迟隐藏。支持配置显示/隐藏延迟。

位置自动翻转

当 Popover 超出视口边界时,会自动翻转方向(例如 bottom 空间不足会翻转为 top),并会进行边界矫正,确保内容完整显示在屏幕内。

API

Props

属性类型默认值说明
placement'top' | 'bottom' | 'left' | 'right''bottom'弹出位置
delaynumber0显示延迟(毫秒)
hideDelaynumber100隐藏延迟(毫秒)
offsetnumber8与触发元素的偏移量(像素)

Slots

名称说明
trigger触发元素(支持默认插槽作为后备)
content弹出内容

注意事项

  • Popover 适用于鼠标悬浮触发的轻量内容,不适合需要点击外部关闭、受控模式的复杂场景。如需此类功能,可基于本组件扩展。
  • 触发区域和内容区域之间移动时,延迟机制保证不会闪烁消失。
  • 内容宽度由内容决定,可通过 CSS 设置 min-widthwidth

Released under the MIT License