::: sourceCode
## movable-view
> issues: https://issues.dcloud.net.cn/?mid=component.view-container.movable.movable-view
:::
可移动的视图容器,在页面中可以拖拽滑动
### 兼容性
之所以有movable-area和movable-view,是因为逻辑层和视图层分离,从视图层发送数据给逻辑层,处理后再传回视图层会产生损耗,导致拖动卡顿。\
于是通过一个框架实现好的组件,在视图层内部处理拖动,避免来回通信。
但在uni-app x上,web和app上不存在通信损耗。小程序上,通过UniElement操作style并编译成了小程序的wxs和ajs,也不再存在通信损耗了。
可以在需要拖动的组件上监听touchmove,touchmove中使用UniElement.style?.setProperty('transform', 'translate(' + x + 'px,' + y + 'px)')。该写法跨平台且高性能。
在hello uni-app x里有示例,可以自由的监听view的拖动并移动其位置。[详见](https://gitcode.com/dcloud/hello-uni-app-x/blob/alpha/pages/component/general-event/touch-event.uvue)
### 属性
| 名称 | 类型 | 兼容性 | 描述 |
| :- | :- | :-: | :- |
| direction | string | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | movable-view的移动方向,属性值有all、vertical、horizontal、none |
| inertia | boolean | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | movable-view 是否带有惯性。 |
| out-of-bounds | boolean | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 超过可移动区域后,movable-view 是否还可以移动。 |
| x | string \| number | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 定义 x 轴方向的偏移,如果 x 的值不在可移动范围内,会自动移动到可移动范围;改变 x 的值会触发动画。 |
| y | string \| number | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 定义 y 轴方向的偏移,如果 y 的值不在可移动范围内,会自动移动到可移动范围;改变 y 的值会触发动画。 |
| damping | number | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 阻尼系数,用于控制 x 或 y 改变时的动画和过界回弹的动画,值越大移动越快。 |
| friction | number | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 摩擦系数,用于控制惯性滑动的动画,值越大摩擦力越大,滑动越快停止;必须大于0,否则会被设置成默认值 2。 |
| disabled | boolean | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 是否禁用。 |
| scale | boolean | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 是否支持双指缩放,默认缩放手势生效区域是在 movable-view 内。 |
| scale-min | number | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 定义缩放倍数最小值,默认为 0.5。 |
| scale-max | number | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 定义缩放倍数最大值,默认为 10。 |
| scale-value | number | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 定义缩放倍数,取值范围为 0.5 - 10 |
| animation | boolean | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 是否使用动画,默认为 true。 |
| htouchmove | eventhandle | Web: -; 微信小程序: 4.41; 支付宝小程序: x; Android: -; iOS: -; HarmonyOS: - | *(eventhandle)*
初次手指触摸后移动为横向的移动时触发,如果catch此事件,则意味着touchmove事件也被catch |
| vtouchmove | eventhandle | Web: -; 微信小程序: 4.41; 支付宝小程序: x; Android: -; iOS: -; HarmonyOS: - | *(eventhandle)*
初次手指触摸后移动为纵向的移动时触发,如果catch此事件,则意味着touchmove事件也被catch |
| @change | (event: [UniEvent](/component/common.md#unievent)) => void | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 拖动过程中触发的事件,event.detail = {x: x, y: y, source: source}。其中source表示产生移动的原因,值可为touch(拖动)、touch-out-of-bounds(超出移动范围)、out-of-bounds(超出移动范围后的回弹)、friction(惯性)和空字符串(setData)。 |
| @scale | (event: [UniEvent](/component/common.md#unievent)) => void | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | 缩放过程中触发的事件,event.detail = {x: x, y: y, scale: scale}。 |
#### direction 的属性描述
| 合法值 |
| :- |
| all |
| vertical |
| horizontal |
| none |
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/component/movable-view/movable-view.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/component/movable-view/movable-view.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/movable-view/movable-view
>示例
```vue
示例 1
\nmovable-view 区域小于 movable-area
text
点击这里移动至 (30px, 30px)
示例 2
\nmovable-view区域大于movable-area
text
示例 3
\n只可以横向移动
text
示例 4
\n只可以纵向移动
text
示例 5
\n可超出边界
text
示例 6
\n带有惯性
text
示例 7
\n可放缩
text
点击这里放大3倍
```
:::
### 参见
- [参见uni-app相关文档](https://uniapp.dcloud.io/component/movable-view.html)