Tui

FloatBox 浮动框
可拖动的浮动容器,支持边界限制和自定义样式
基础用法
基本的可拖动浮动框,支持鼠标拖拽移动。
可拖动的盒子
示例代码
vue
限制边界
设置边界限制,防止拖出指定区域。
边界限制
示例代码
vue
自定义样式
自定义浮动框样式,支持圆形和百分比初始位置。
居中显示
示例代码
vue
多个浮动框
在同一容器中放置多个浮动框,各自独立拖动。
浮动框 1
浮动框 2
浮动框 3
示例代码
vue
事件监听
监听拖动开始、拖动中、拖动结束事件,获取实时位置信息。
事件监听

拖动事件

示例代码
vue
高级应用
展示不同形状的浮动框和实际应用场景,如悬浮工具栏。

不同形状和样式

方形
圆形
圆角

实际应用场景

悬浮工具
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
initialPosition
初始位置
{ x?: number | string; y?: number | string }
-
{ x: 100, y: 100 }
-
boundaries
边界限制
{ minX?: number | string; minY?: number | string; maxX?: number | string; maxY?: number | string }
-
undefined
-
positionMode
定位模式:fixed(相对视口) / absolute(相对父容器)
'fixed' | 'absolute'
fixed / absolute
fixed
-
shape
外层形状
'square' | 'circle'
square / circle
square
-
shadow
是否显示阴影
boolean
true / false
true
-
事件 Events
事件名
说明
回调参数
版本说明
dragStart
开始拖动时触发
(position: { x: number; y: number }) => void
-
dragMove
拖动过程中触发
(position: { x: number; y: number }) => void
-
dragEnd
拖动结束时触发
(position: { x: number; y: number }) => void
-
positionChange
拖动过程中位置变化触发(兼容事件)
(position: { x: number; y: number }) => void
-
基础用法
限制边界
自定义样式
多个浮动框
事件监听
高级应用
属性 Props
事件 Events