更新时间:2023-11-30 19:00:20贡献者 3收藏订阅更新我的文档设置返回文档简介可移动的视图容器,在页面中可以拖拽滑动。movable-view 必须在 movable-area 组件中,并且必须是直接子节点,否则不能移动。使用限制●版本要求基础库 1.11.0 及以上,若版本较低,建议做 兼容处理。●native 渲染引擎:暂不支持。可以通过 my.caniuse('movable-view') 判断是否支持。●movable-view 必须设置 width 和 height 属性,不设置默认为 10px。●movable-view 默认为绝对定位(请不要修改),top 和 left 属性为 0px。●当 movable-view 小于 movable-area 时,movable-view 的移动范围是在 movable-area 内;当 movable-view 大于 movable-area 时,movable-view 的移动范围必须包含 movable-area (x 轴方向和 y 轴方向分开考虑)。扫码体验使用在线示例属性说明属性类型描述directionstringmovable-view 的移动方向,属性值有 all、vertical、horizontal、none。 默认值: noneinertiabooleanmovable-view 是否带有惯性。 默认值: false 版本要求: 基础库 1.20.0 及以上out-of-boundsboolean超过可移动区域后,movable-view 是否还可以移动。 默认值: false 版本要求: 基础库 1.20.0 及以上xnumber定义 x 轴方向的偏移,会换算为 left 属性,如果 x 的值不在可移动范围内,会自动移动到可移动范围。 默认值: 0ynumber定义 y 轴方向的偏移,会换算为 top 属性,如果 y 的值不在可移动范围内,会自动移动到可移动范围。 默认值: 0dampingnumber阻尼系数,用于控制 x 或 y 改变时的动画和过界回弹的动画,值越大移动越快。 默认值: 20 版本要求: 基础库 1.20.0 及以上frictionnumber摩擦系数,用于控制惯性滑动的动画,值越大摩擦力越大,滑动越快停止;必须大于 0,否则会被设置成默认值。 默认值: 2 版本要求: 基础库 1.20.0 及以上disabledboolean是否禁用。 默认值: falsescaleboolean是否支持双指缩放,默认缩放手势生效区域是在 movable-view 内。 默认值: false 版本要求: 基础库 1.20.0 及以上scale-minnumber定义缩放倍数最小值。 默认值: 0.5 版本要求: 基础库 1.20.0 及以上scale-maxnumber定义缩放倍数最大值。 默认值: 10 版本要求: 基础库 1.20.0 及以上scale-valuenumber定义缩放倍数,取值范围为 0.5 - 10。 默认值: 1 版本要求: 基础库 1.20.0 及以上animationboolean是否使用动画。 默认值: false 版本要求: 基础库 1.20.0 及以上ontouchstarteventhandle触摸动作开始,事件会向父节点传递。 版本要求: 基础库 1.11.5 及以上catchtouchstarteventhandle触摸动作开始,事件仅作用于组件,不向父节点传递。 版本要求: 基础库 1.11.5 及以上ontouchmoveeventhandle触摸移动事件,事件会向父节点传递。 版本要求: 基础库 1.11.5 及以上catchtouchmoveeventhandle触摸移动事件,事件仅作用于组件,不向父节点传递。 版本要求: 基础库 1.11.5 及以上ontouchendeventhandle触摸动作结束,事件会向父节点传递。 版本要求: 基础库 1.11.5 及以上catchtouchendeventhandle触摸动作结束,事件仅作用于组件,不向父节点传递。 版本要求: 基础库 1.11.5 及以上ontouchcanceleventhandle触摸动作被打断,如来电提醒、弹窗。 版本要求: 基础库 1.11.5 及以上onchangeeventhandle拖动过程中触发的事件,event.detail = {x: x, y: y, source: source},其中 source 表示产生移动的原因,值可为 touch(拖动)。onchangeendeventhandle拖动结束触发的事件,event.detail = {x: x, y: y}。onscaleeventhandle缩放过程中触发的事件,event.detail = {x, y, scale}。 版本要求: 基础库 1.20.0 及以上onchange 返回值 detail.sourcesource 字段表示产生移动的原因属性描述touch拖动。touch-out-of-bounds超出移动范围。out-of-bounds超出移动范围后的回弹。friction惯性。空字符串setdata。说明: 冒泡事件,请查看 事件介绍 中的 事件类型。