UIActivityViewControllerCompletionEvent
UIActivityViewControllerCompletionEvent 表示系统的分享面板结束了,带着用户选了什么、做没做完。
UIActivityViewController 的 complete 事件是它。
继承关系:Event → UIActivityViewControllerCompletionEvent
构造函数
UIActivityViewControllerCompletionEvent()
创建一个 UIActivityViewControllerCompletionEvent。运行时派发下面这些事件时自己创建它;App 的代码可以用它建一个事件对象,用 dispatchEvent() 派发出去,试一试监听器。
实例属性
还继承 Event 的属性,最常用的是 type 和 target。下表的属性都是只读的,给它们赋值抛 TypeError。
| 属性 | 说明 |
|---|---|
activityType 只读 | 用户选的去处 |
completed 只读 | 选的动作做完了没有 |
activityError 只读 | 动作失败时系统给的错误 |
这些属性在原型上,不在事件对象自己身上:Object.keys(event) 和 { ...event } 拿不到它们,要一个一个读。见带字段的事件。
哪些事件是这个类
| 对象 | 事件 |
|---|---|
UIActivityViewController | complete |
不能取消:cancelable 是 false,preventDefault() 不起作用。
示例
js
const sheet = new UIActivityViewController([new URL('https://example.com')]);
sheet.addEventListener('complete', (e) => {
console.log(e instanceof UIActivityViewControllerCompletionEvent, e.completed, e.activityType);
});效果:面板结束时,输出 true、做没做完和用户选的去处。
对应的 iOS API
UIActivityViewController.completionWithItemsHandler 的四个参数里,三个是事件对象的同名字段。
| ObjC | JS |
|---|---|
activityType | event.activityType |
completed | event.completed |
activityError | event.activityError |
参见
UIActivityViewController:派发这个事件的对象complete:什么时候派发