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
| ObjC | JS |
|---|---|
property.contact、key、value、identifier、label | 相同 |
参见
contactpropertyselect:它从这里来CNContact:contact的类型CNLabeledValue:identifier和label对应的那一项