联系地址

有限可用性

此功能不是基线,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在一些或所有支持的浏览器中。

实验性:这是一个实验性技术
在生产环境中使用此功能之前,请仔细查看浏览器兼容性表

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 表格仅在浏览器中加载