CNContactFormatter
CNContactFormatter 把联系人的姓名拼成一行。名和姓谁在前、中间有没有空格,由系统按姓名本身的文字和用户的设置定:中文、日文的姓在前,英文的名在前。
要先装 @nacrejs/contacts,装法见 CNContactPickerViewController。
继承关系:EventTarget → NSObject → CNContactFormatter
构造函数
不能用 new 创建。它只有一个静态方法。
new CNContactFormatter() 抛 TypeError: Illegal constructor: CNContactFormatter has no instances here; use CNContactFormatter.stringFromContact(contact, { style })。
静态方法
CNContactFormatter.stringFromContact()
把一个联系人的姓名或姓名的注音拼成一行。
示例
js
/// <reference types="@nacrejs/types" />
/// <reference types="@nacrejs/contacts" />
const picker = new CNContactPickerViewController();
picker.addEventListener('contactselect', (event) => {
const name = CNContactFormatter.stringFromContact(event.contact, { style: 'fullName' });
console.log(name === null ? '(没有名字)' : name);
});效果:选中名是 Alex、姓是 Chen 的联系人时输出 Alex Chen;选中名是「小明」、姓是「陈」的联系人时输出 陈小明。
对应的 iOS API
| ObjC | JS |
|---|---|
[CNContactFormatter stringFromContact:contact style:CNContactFormatterStyleFullName] | CNContactFormatter.stringFromContact(contact, { style: 'fullName' }) |