Skip to content

CNContactPickerViewController:contactsselect 事件 ​

contactsselect 事件在多选的选择器上、用户勾选完点了「完成」时派发。监听它,选择器就是多选的。

语法 ​

picker.addEventListener('contactsselect', (event) => { })

事件对象 ​

Event,多一个字段:

contacts

用户勾选的联系人,CNContact 的数组。一个都没勾就点「完成」时是不是空数组,没有验证。

target 是这个选择器。不能取消,preventDefault() 不起作用。

什么时候派发 ​

  • 用户点了「完成」。选择器随即由系统关掉。
  • 监听了它,选择器就是多选的:每个联系人前面有一个勾选框。同时监听的 contactselect、contactpropertyselect 不会来。
  • 一个选择器弹出一次,最多派发一次。

这些行为未在模拟器验证。

示例 ​

js
const page = new UIViewController();
const picker = new CNContactPickerViewController();
picker.addEventListener('contactsselect', (event) => {
  const names = event.contacts.map((contact) =>
    CNContactFormatter.stringFromContact(contact, { style: 'fullName' }));
  console.log('选了 ' + names.length + ' 个:' + names.join('、'));
});
page.presentViewController(picker, { animated: true });

效果:列表里每个联系人前面有一个勾选框,右上角有「完成」。勾两个再点「完成」,选择器关掉,控制台输出 选了 2 个:Alex Chen、Sam Rivera。

对应的 iOS API ​

-[CNContactPickerDelegate contactPicker:didSelectContacts:]。

参见 ​