::: 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 ``` ::: ### 参见 - [参见uni-app相关文档](https://uniapp.dcloud.io/component/movable-view.html)