CNContactPickerViewController:contactpropertyselect 事件
contactpropertyselect 事件在用户进入一个联系人的详情、点了其中一项(一个电话、一个邮箱)时派发。监听它,选择器就是「选某一项」的选法。
语法
picker.addEventListener('contactpropertyselect', (event) => { })事件对象
Event,多一个字段:
contactProperty
用户选中的那一项,CNContactProperty:哪个联系人、哪个字段、哪个值。
target 是这个选择器。不能取消,preventDefault() 不起作用。
什么时候派发
- 用户点一个联系人,选择器进入这个联系人的详情;用户再点详情里的一项,派发这个事件,选择器随即由系统关掉。
- 详情里显示哪些字段由
displayedPropertyKeys决定。 - 同时监听了
contactsselect时选择器是多选的,这个事件不会来。 - 一个选择器弹出一次,最多派发一次。
这些行为未在模拟器验证。
示例
js
const page = new UIViewController();
const picker = new CNContactPickerViewController();
picker.displayedPropertyKeys = ['phoneNumbers'];
picker.addEventListener('contactpropertyselect', (event) => {
const property = event.contactProperty;
if (property.value instanceof CNPhoneNumber) {
console.log(property.value.stringValue);
}
});
page.presentViewController(picker, { animated: true });效果:点一个联系人,详情里只有电话那几行;点其中一个号码,选择器关掉,控制台输出这个号码,比如 555-0100。
对应的 iOS API
-[CNContactPickerDelegate contactPicker:didSelectContactProperty:]。一次选几项的 contactPicker:didSelectContactProperties: 还没有提供。