> 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.

# movable-view

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

<iframe src="https://developer.doubao.com/docs-preview/component-simulator/?caseId=movable"
  title="组件示例 movable-view"
  width="100%"
  height="700"
  loading="lazy"
  style="width:100%;height:700px;border:0;border-radius:16px;overflow:hidden;"
></iframe>

## 扫码预览

![扫码预览 movable-view](https://api.qrserver.com/v1/create-qr-code/?size=200x200\&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fcomponent%252Fmovable%252Findex)

## Props

<table>
<thead>
<tr><th width="140">属性名</th><th width="240">类型</th><th width="120">默认值</th><th width="80">必填</th><th width="360">说明</th></tr>
</thead>
<tbody>
<tr><td>animation</td><td><code>boolean</code></td><td>true</td><td>否</td><td>是否启用动画</td></tr>
<tr><td>children</td><td><code>ReactNode</code></td><td>-</td><td>否</td><td>子组件</td></tr>
<tr><td>className</td><td><code>string</code></td><td>-</td><td>否</td><td>组件类名</td></tr>
<tr><td>damping</td><td><code>number</code></td><td>20</td><td>否</td><td>阻尼系数，用于控制 x/y 改变时的动画和越界回弹动画。值越大越快。</td></tr>
<tr><td>direction</td><td><code>&quot;all&quot; | &quot;none&quot; | &quot;horizontal&quot; | &quot;vertical&quot;</code></td><td>'none'</td><td>否</td><td>移动方向<br>- 'all'：允许所有方向移动<br>- 'vertical'：只允许垂直移动<br>- 'horizontal'：只允许水平移动<br>- 'none'：不允许移动</td></tr>
<tr><td>disabled</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否禁用移动</td></tr>
<tr><td>friction</td><td><code>number</code></td><td>2</td><td>否</td><td>摩擦系数，用于控制惯性滑动衰减。值越大摩擦越大，越快停止；必须 &gt; 0。</td></tr>
<tr><td>inertia</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否启用惯性滑动</td></tr>
<tr><td>onDrag</td><td><code>(x: number, y: number) =&gt; void</code></td><td>-</td><td>否</td><td>拖拽移动时触发</td></tr>
<tr><td>onScale</td><td><code>(scale: number) =&gt; void</code></td><td>-</td><td>否</td><td>双指缩放时触发</td></tr>
<tr><td>outOfBounds</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否允许超出可移动区域</td></tr>
<tr><td>scale</td><td><code>boolean</code></td><td>false</td><td>否</td><td>是否允许缩放</td></tr>
<tr><td>scaleMax</td><td><code>number</code></td><td>10</td><td>否</td><td>最大缩放比例</td></tr>
<tr><td>scaleMin</td><td><code>number</code></td><td>0.5</td><td>否</td><td>最小缩放比例</td></tr>
<tr><td>scaleValue</td><td><code>number</code></td><td>1</td><td>否</td><td>初始缩放值</td></tr>
<tr><td>style</td><td><code>CSSProperties</code></td><td>-</td><td>否</td><td>组件样式</td></tr>
<tr><td>x</td><td><code>number</code></td><td>0</td><td>否</td><td>初始 X 轴偏移</td></tr>
<tr><td>y</td><td><code>number</code></td><td>0</td><td>否</td><td>初始 Y 轴偏移</td></tr>
</tbody>
</table>
