PHPickerViewController:pick 事件
pick 事件在用户选好了、或者点了取消时派发。事件对象的 results 是选中的那几项。
语法
picker.addEventListener('pick', (event) => { })事件对象
一个 Event,多一个字段:
results
PHPickerResult 的数组,只读(冻结的)。用户点了取消时是空数组。selection 是 'ordered' 或 'continuousAndOrdered' 时,按用户选的先后排。
监听器收到的参数类型是 Event,读 results 要转一次类型:/** @type {PHPickerViewControllerFinishEvent} */ (event)。
不可取消。回调在事件发生之后的下一轮执行。
什么时候派发
选图界面有三种结束方式:
| 用户做了什么 | 派发什么 |
|---|---|
| 选好了,点右上角的「添加」。只允许选一项时,点中那一项就算选好 | pick,results 是选中的项 |
| 点左上角的「取消」 | pick,results 是空数组 |
| 把界面向下拖走 | 页面的 dismiss 事件。会不会同时派发一次 results 为空的 pick,未在模拟器验证 |
- 选图界面不会自己关掉。 派发
pick之后它还在屏幕上,要在监听器里调dismissViewController()。对已经被拖走的选择器再调一次dismissViewController()会怎样,未在模拟器验证。 selection是'continuous'或'continuousAndOrdered'时,每选中或取消一项就派发一次,results是当时选中的全部。这种方式下不要在监听器里关界面。- 自己用
dispatchEvent()派发的pick事件上没有results。
示例
js
const page = new UIViewController();
const picker = new PHPickerViewController(new PHPickerConfiguration());
picker.addEventListener('pick', (event) => {
const { results } = /** @type {PHPickerViewControllerFinishEvent} */ (event);
picker.dismissViewController({ animated: true });
console.log(results.length === 0 ? '取消了' : '选了 ' + results.length + ' 项');
});
page.presentViewController(picker, { animated: true });效果(未在模拟器验证):用户选一项,选图界面消失,控制台输出 选了 1 项。点「取消」,输出 取消了。
对应的 iOS API
委托方法 picker:didFinishPicking:。JS 里不设委托,监听这个事件;参数 results 在事件对象上。
参见
PHPickerResult:results里每一项的类型NSItemProvider:从选中的项上取图片- 从相册选图、把图存进相册
- 这个类属于
@nacrejs/photos包,装法见要先安装