Skip to content

CNContactPickerContactsEvent ​

CNContactPickerContactsEvent 表示用户在系统的选联系人界面里勾选了几个联系人,点了「完成」。

CNContactPickerViewController 的 contactsselect 事件是它,contacts 是勾选的联系人。

它属于 @nacrejs/contacts 这个包,装法见 CNContactPickerViewController。

继承关系:Event → CNContactPickerContactsEvent

构造函数 ​

CNContactPickerContactsEvent()

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

实例属性 ​

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

属性说明
contacts 只读用户勾选的联系人

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

哪些事件是这个类 ​

对象事件
CNContactPickerViewControllercontactsselect

不能取消:cancelable 是 false,preventDefault() 不起作用。派发之后选择器由系统关掉。

示例 ​

js
const page = new UIViewController();
const picker = new CNContactPickerViewController();
picker.addEventListener('contactsselect', (e) => {
  console.log(e instanceof CNContactPickerContactsEvent);
});
page.presentViewController(picker, { animated: true });

效果:用户在选择器里选好之后,输出 true。未在模拟器验证。

对应的 iOS API ​

ObjCJS
contactPicker:didSelectContacts:contactsselect 事件
参数 contactsevent.contacts

参见 ​