Popover

弹出层:点击触发,内容可交互,自动定位并支持翻转,外部点击或 Escape 关闭后把焦点还给触发元素。

属性

属性类型默认值说明
openboolean—受控开关
defaultOpenbooleanfalse非受控初始开关
onOpenChange(open: boolean) => void—开关变化回调
placement'top' | 'bottom' | 'left' | 'right''bottom'期望方向:top / bottom / left / right
align'start' | 'center' | 'end''center'交叉轴对齐:start / center / end
offsetnumber8与触发元素的间距
Popover.TriggerButtonHTMLAttributes—触发按钮,负责开关与 aria 关联
Popover.ContentHTMLAttributes—浮层内容,role="dialog",可交互
closeOnInteractOutsidebooleantrue点击外部关闭,默认 true
closeOnEscapebooleantrue按 Escape 关闭,默认 true