选择应用类型
企业内部应用开发

movable-view 可移动视图容器

更新于 2023-08-06本文介绍可移动视图容器组件的使用。

movable-view 可移动的视图容器,在页面中可以拖拽滑动。movable-view 必须在movable-area 可移动视图区域 组件中,并且必须是直接子节点,否则不能移动。

重要

  • 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 轴方向分开考虑)。

扫码体验

属性

属性

类型

描述

direction

String

movable-view 的移动方向,属性值有 all、vertical、horizontal、none。

默认值:none。

inertia

Boolean

movable-view 是否带有惯性。

默认值:false。

版本:1.20.0及以上。

out-of-bounds

Boolean

超过可移动区域后,movable-view 是否还可以移动。

默认值:false。

版本:1.20.0及以上。

x

Number

定义 x 轴方向的偏移,会换算为 left 属性,如果 x 的值不在可移动范围内,会自动移动到可移动范围。

默认值:0。

y

Number

定义 y 轴方向的偏移,会换算为 top 属性,如果 y 的值不在可移动范围内,会自动移动到可移动范围。

默认值:0。

damping

Number

阻尼系数,用于控制x或y改变时的动画和过界回弹的动画,值越大移动越快。

默认值:20。

版本:1.20.0及以上。

friction

Number

摩擦系数,用于控制惯性滑动的动画,值越大摩擦力越大,滑动越快停止;必须大于 0,否则会被设置成默认值。

默认值:2。

版本:1.20.0及以上。

disabled

Boolean

是否禁用。

默认值:false。

scale

Boolean

是否支持双指缩放,默认缩放手势生效区域是在 movable-view 内。

默认值:false。

版本:1.20.0及以上。

scale-min

Number

定义缩放倍数最小值。

默认值:0.5。

版本:1.20.0及以上。

scale-max

Number

定义缩放倍数最大值。

默认值:10。

版本:1.20.0及以上。

scale-value

Number

定义缩放倍数,取值范围为 0.5 - 10。

默认值:1。

版本:1.20.0及以上。

animation

Boolean

是否使用动画。

默认值:false。

版本:1.20.0及以上。

onTouchStart

EventHandle

触摸动作开始,事件会向父节点传递。

catchTouchStart

EventHandle

触摸动作开始,事件仅作用于组件,不向父节点传递。

onTouchMove

EventHandle

触摸移动事件,事件会向父节点传递。

catchTouchMove

EventHandle

触摸移动事件,事件仅作用于组件,不向父节点传递。

onTouchEnd

EventHandle

触摸动作结束,事件会向父节点传递。

catchTouchEnd

EventHandle

触摸动作结束,事件仅作用于组件,不向父节点传递。

onTouchCancel

EventHandle

触摸动作被打断,如来电提醒、弹窗。

onChange

EventHandle

拖动过程中触发的事件,event.detail = {x: x, y: y, source: source},其中 source 表示产生移动的原因,值可为 touch(拖动)。

onChangeEnd

EventHandle

拖动结束触发的事件event.detail= {x: x, y: y}

onScale

EventHandle

缩放过程中触发的事件event.detail = {x, y, scale}。

版本:1.20.0及以上。

onChange返回值detail.source

source字段表示产生移动的原因:

返回值

说明

touch

拖动。

touch-out-of-bounds

超出移动范围。

out-of-bounds

超出移动范围后的回弹。

friction

惯性。

空字符串

setData。

示例代码

.axml示例代码:

Loading...

.js示例代码:

Loading...

.json示例代码:

Loading...

.acss代码示例:

Loading...
这篇文档是否有帮助?
本页内容
点击纠错