Skip to content

CNContactProperty ​

CNContactProperty 表示用户在联系人详情里选中的那一项:哪个联系人的哪个字段的哪个值。比如用户点了 Alex Chen 的手机号码,它说明联系人是 Alex Chen、字段是电话、值是那个号码。

它由选择器的 contactpropertyselect 事件交给 App。

要先装 @nacrejs/contacts,装法见 CNContactPickerViewController。

继承关系:EventTarget → NSObject → CNContactProperty

构造函数 ​

不能用 new 创建,只能从 contactpropertyselect 事件的 contactProperty 拿到。

new CNContactProperty() 抛 TypeError: Illegal constructor: CNContactProperty is a read-only value handed over by CNContactPickerViewController, not created by new。

实例属性 ​

都是只读的。还继承 NSObject 的属性。

属性说明
contact 只读这一项属于哪个联系人
key 只读字段名,比如 'phoneNumbers'
value 只读选中的值
identifier 只读选中的是带标签的值里的一项时,那一项的标识
label 只读选中的是带标签的值里的一项时,那一项的标签原文

示例 ​

js
/// <reference types="@nacrejs/types" />
/// <reference types="@nacrejs/contacts" />

const picker = new CNContactPickerViewController();
picker.addEventListener('contactpropertyselect', (event) => {
  const property = event.contactProperty;
  const value = property.value;
  const text = value instanceof CNPhoneNumber ? value.stringValue : value;
  console.log(property.key, text);
});

效果:用户在详情里点了一个电话时输出 phoneNumbers 555-0100;点了一个邮箱时输出 emailAddresses alex@example.com;点了地址、生日这类字段时输出字段名和 null。

对应的 iOS API ​

ObjCJS
property.contact、key、value、identifier、label相同

参见 ​