Skip to content

Popper

Popper 是 floating-ui 的高阶封装, 不存在太多的自定义样式. 当你需要悬浮一个元素,且不想要其他样式的时候, Popper是一个很不错的选择.

基本用法

展开

响应式

popper的所有参数都是响应式的

展开

虚拟触发

展开

右键菜单

展开

反转和AutoPlacement有什么区别

flipauto-placement最本质的区别就是, auto-placement并不一定是反方向的,但flip一般会在空间不足时反转到另一侧。

Props

Popper

参数名参数类型类型简介示例默认值
virtualTriggerBoolean是否使用虚拟触发器#虚拟触发false
triggerRefHTMLElement | VirtualTrigger虚拟触发器元素#虚拟触发-
placementPlacement默认位置#基本用法'top'
autoPlacementBoolean是否自动选择位置#基本用法false
offsetNumber浮动元素与触发器之间的偏移量#响应式8
flipBoolean是否自动翻转位置-true
middlewaresPopperMiddlewares自定义中间件-[]
safepolyBoolean安全三角形-true
safepolyDebugBoolean是否显示安全三角-false

Types

typescript
export type PopperTrigger = 'click' | 'hover' | 'contextmenu' | 'focus'
export type PopperPlacement = Placement;
export type PopperFlipOptions = FlipOptions;
export type PopperShiftOptions = ShiftOptions;
export type PopperMiddlewares = Middleware[]