For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/components/view-container/movable-view.md.

movable-view

可移动视图组件,支持拖拽移动、双指缩放、惯性滑动、越界回弹等交互。

扫码预览

扫码预览 movable-view

Props

属性名类型默认值必填说明
animationbooleantrue否是否启用动画
childrenReactNode-否子组件
classNamestring-否组件类名
dampingnumber20否阻尼系数,用于控制 x/y 改变时的动画和越界回弹动画。值越大越快。
direction"all" | "none" | "horizontal" | "vertical"'none'否移动方向
  • 'all':允许所有方向移动
  • 'vertical':只允许垂直移动
  • 'horizontal':只允许水平移动
  • 'none':不允许移动
disabledbooleanfalse否是否禁用移动
frictionnumber2否摩擦系数,用于控制惯性滑动衰减。值越大摩擦越大,越快停止;必须 > 0。
inertiabooleanfalse否是否启用惯性滑动
onDrag(x: number, y: number) => void-否拖拽移动时触发
onScale(scale: number) => void-否双指缩放时触发
outOfBoundsbooleanfalse否是否允许超出可移动区域
scalebooleanfalse否是否允许缩放
scaleMaxnumber10否最大缩放比例
scaleMinnumber0.5否最小缩放比例
scaleValuenumber1否初始缩放值
styleCSSProperties-否组件样式
xnumber0否初始 X 轴偏移
ynumber0否初始 Y 轴偏移