ContactAddress
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只读 实验性-
一个字符串,指定管辖区用于邮件路由的代码,例如,美国的 ZIP 代码或印度的 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 |
浏览器兼容性
加载中…