联系地址
ContactAddress
是联系选择器 API的接口,它代表一个物理地址。此接口的实例是从ContactsManager.getProperties()
返回的对象的address
属性中检索的。
您可能需要参考万国邮政联盟网站的地址 S42 标准材料,其中提供有关邮政地址国际标准的信息。
实例属性
ContactAddress.addressLine
只读 实验性-
一个字符串数组,提供地址的每一行,不包括其他属性中的内容。确切的大小和内容因国家或地区而异,可能包括街道名称、门牌号码、公寓号码、农村配送路线、描述性说明或邮政信箱号码等。
ContactAddress.country
只读 实验性-
一个字符串,使用ISO-3166-1 alpha-2标准指定地址所在的国家。该字符串始终以其规范的大写形式给出。一些有效的
country
值示例:"US"
、"GB"
、"CN"
或"JP"
。 ContactAddress.city
只读 实验性-
一个字符串,包含地址的城市或城镇部分。
ContactAddress.dependentLocality
只读 实验性-
一个字符串,给出城市内的从属地区或次级地区,例如街区、行政区、地区或英国从属地区。
ContactAddress.organization
只读 实验性-
一个字符串,指定地址处的组织、公司、机构或机构的名称。
ContactAddress.phone
只读 实验性-
一个字符串,指定收件人或联系人电话号码。
ContactAddress.postalCode
只读 实验性-
一个字符串,指定管辖区用于邮件路由的代码,例如美国的邮政编码或印度的 PIN 码。
ContactAddress.recipient
只读 实验性-
一个字符串,给出地址处的收件人、购买者或联系人的姓名。
ContactAddress.region
只读 实验性-
一个字符串,包含国家/地区的顶级行政划分,例如州、省、州或县。
ContactAddress.sortingCode
只读 实验性-
一个字符串,提供法国等国家使用的邮政分类代码。
实例方法
ContactAddress.toJSON()
实验性-
一个标准序列化器,返回
ContactAddress
对象的属性的 JSON 表示形式。
示例
以下示例提示用户选择联系人,然后将第一个返回的地址打印到控制台。
js
const props = ["address"];
const opts = { multiple: true };
async function getContacts() {
try {
const contacts = await navigator.contacts.select(props, opts);
const contactAddress = contacts[0].address[0];
console.log(contactAddress);
} catch (ex) {
// Handle any errors here.
}
}
规范
规范 |
---|
联系选择器 API # contactaddress |
浏览器兼容性
BCD 表格仅在浏览器中加载