Skip to content

UIScrollViewDragEndEvent ​

UIScrollViewDragEndEvent 表示用户拖动滚动视图之后、松手的那一刻。

UIScrollView 的 beforedragend 事件是它。它带着松手时的速度和内容将要停下的位置;监听器可以改这个位置,让内容停在别处,比如对齐到一行的边界。

继承关系:Event → UIScrollViewDragEndEvent

构造函数 ​

UIScrollViewDragEndEvent()

创建一个 UIScrollViewDragEndEvent。运行时派发下面这些事件时自己创建它;App 的代码可以用它建一个事件对象,用 dispatchEvent() 派发出去,试一试监听器。

实例属性 ​

还继承 Event 的属性,最常用的是 type 和 target。下表的属性除了 targetContentOffset 都是只读的,给只读的属性赋值抛 TypeError。

属性说明
velocity 只读松手时内容移动的速度
targetContentOffset内容停下时的位置。可写,写了内容就停在那里

这些属性在原型上,不在事件对象自己身上:Object.keys(event) 和 { ...event } 拿不到它们,要一个一个读。见带字段的事件。

哪些事件是这个类 ​

对象事件
UIScrollView 和它的子类beforedragend

不能取消:cancelable 是 false,preventDefault() 不起作用。要让内容停在原地,把 targetContentOffset 写成当前的 contentOffset。

示例 ​

js
const scroller = new UIScrollView();
scroller.addEventListener('beforedragend', (e) => {
  console.log(e instanceof UIScrollViewDragEndEvent, e.velocity.y, e.targetContentOffset.y);
});

效果:拖动 scroller 后松手,输出 true、纵向的速度和系统算出的停下的位置。

对应的 iOS API ​

ObjCJS
scrollViewWillEndDragging:withVelocity:targetContentOffset:beforedragend 事件
参数 velocityevent.velocity
*targetContentOffset = CGPointMake(0, y)event.targetContentOffset = new CGPoint(0, y)

参见 ​