CNContactPickerContactPropertyEvent
CNContactPickerContactPropertyEvent 表示用户在系统的选联系人界面里,点了某个联系人详情里的一项,比如一个电话号码。
CNContactPickerViewController 的 contactpropertyselect 事件是它,contactProperty 是选中的那一项。
它属于 @nacrejs/contacts 这个包,装法见 CNContactPickerViewController。
继承关系:Event → CNContactPickerContactPropertyEvent
构造函数
CNContactPickerContactPropertyEvent()
创建一个 CNContactPickerContactPropertyEvent。运行时派发下面这些事件时自己创建它;App 的代码可以用它建一个事件对象,用 dispatchEvent() 派发出去,试一试监听器。
实例属性
还继承 Event 的属性,最常用的是 type 和 target。下表的属性都是只读的,给它们赋值抛 TypeError。
| 属性 | 说明 |
|---|---|
contactProperty 只读 | 用户在联系人详情里选中的那一项 |
这些属性在原型上,不在事件对象自己身上:Object.keys(event) 和 { ...event } 拿不到它们,要一个一个读。见带字段的事件。
哪些事件是这个类
| 对象 | 事件 |
|---|---|
CNContactPickerViewController | contactpropertyselect |
不能取消:cancelable 是 false,preventDefault() 不起作用。派发之后选择器由系统关掉。
示例
js
const page = new UIViewController();
const picker = new CNContactPickerViewController();
picker.addEventListener('contactpropertyselect', (e) => {
console.log(e instanceof CNContactPickerContactPropertyEvent);
});
page.presentViewController(picker, { animated: true });效果:用户在选择器里选好之后,输出 true。未在模拟器验证。
对应的 iOS API
| ObjC | JS |
|---|---|
contactPicker:didSelectContactProperty: | contactpropertyselect 事件 |
参数 contactProperty | event.contactProperty |
参见
CNContactPickerViewController:派发这个事件的对象contactpropertyselect:什么时候派发