ContactAddress
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Giao diện ContactAddress của Contact Picker API biểu diễn một địa chỉ thực. Các thể hiện của giao diện này được lấy từ thuộc tính address của các đối tượng do ContactsManager.getProperties() trả về.
Bạn cũng nên tham khảo tài liệu về tiêu chuẩn địa chỉ S42 trên trang web của Liên minh Bưu chính Thế giới (Universal Postal Union), nơi cung cấp thông tin về các tiêu chuẩn quốc tế cho địa chỉ bưu chính.
Thuộc tính thể hiện
ContactAddress.addressLineRead only Experimental-
Một mảng chuỗi cung cấp từng dòng của địa chỉ không được bao gồm trong các thuộc tính khác. Kích thước và nội dung chính xác của mảng này thay đổi theo quốc gia hoặc địa điểm và có thể bao gồm, ví dụ, tên đường, số nhà, số căn hộ, tuyến phát hàng vùng nông thôn, chỉ dẫn mô tả hoặc số hộp thư bưu điện.
ContactAddress.countryRead only Experimental-
Một chuỗi chỉ định quốc gia nơi địa chỉ tọa lạc, sử dụng tiêu chuẩn ISO-3166-1 alpha-2. Chuỗi này luôn được cung cấp ở dạng chữ hoa chuẩn tắc. Một vài ví dụ về giá trị
countryhợp lệ:"US","GB","CN"hoặc"JP". ContactAddress.cityRead only Experimental-
Một chuỗi chứa phần thành phố hoặc thị trấn của địa chỉ.
ContactAddress.dependentLocalityRead only Experimental-
Một chuỗi cho biết địa phương phụ thuộc hoặc khu vực con trong một thành phố, ví dụ như khu phố, quận, khu vực hoặc dependent locality ở Vương quốc Anh.
ContactAddress.organizationRead only Experimental-
Một chuỗi chỉ định tên của tổ chức, hãng, công ty hoặc cơ sở tại địa chỉ đó.
ContactAddress.phoneRead only Experimental-
Một chuỗi chỉ định số điện thoại của người nhận hoặc người liên hệ.
ContactAddress.postalCodeRead only Experimental-
Một chuỗi chỉ định mã được một khu vực pháp lý dùng để định tuyến thư, ví dụ như ZIP code ở Hoa Kỳ hoặc PIN code ở Ấn Độ.
ContactAddress.recipientRead only Experimental-
Một chuỗi cho biết tên người nhận, người mua hoặc người liên hệ tại địa chỉ.
ContactAddress.regionRead only Experimental-
Một chuỗi chứa đơn vị hành chính cấp cao nhất của quốc gia, ví dụ như bang, tỉnh, oblast hoặc prefecture.
ContactAddress.sortingCodeRead only Experimental-
Một chuỗi cung cấp mã phân loại bưu chính như loại được dùng tại Pháp.
Phương thức thể hiện
ContactAddress.toJSON()Experimental-
Bộ tuần tự hóa tiêu chuẩn trả về biểu diễn JSON của các thuộc tính của đối tượng
ContactAddress.
Ví dụ
Ví dụ sau nhắc người dùng chọn danh bạ, rồi in địa chỉ đầu tiên được trả về ra console.
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.
}
}
Thông số kỹ thuật
| Specification |
|---|
| Contact Picker API> # contactaddress> |