ContactAddress
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das ContactAddress
Interface der Contact Picker API repräsentiert eine physische Adresse. Instanzen dieses Interfaces werden aus der address
-Eigenschaft der Objekte abgerufen, die durch ContactsManager.getProperties()
zurückgegeben werden.
Es kann nützlich sein, auf die Materialien des Addressing S42 Standards der Universal Postal Union zu verweisen, die Informationen über internationale Standards für Postadressen bereitstellen.
Instanz-Eigenschaften
ContactAddress.addressLine
Schreibgeschützt Experimentell-
Ein Array von Zeichenketten, das jede Zeile der Adresse bereitstellt, die nicht unter die anderen Eigenschaften fällt. Die genaue Größe und der Inhalt variieren je nach Land oder Region und können beispielsweise einen Straßennamen, Hausnummer, Wohnungsnummer, ländliche Lieferroute, beschreibende Anweisungen oder Postfachnummer enthalten.
ContactAddress.country
Schreibgeschützt Experimentell-
Eine Zeichenkette, die das Land angibt, in dem sich die Adresse befindet, gemäß dem ISO-3166-1 alpha-2 Standard. Die Zeichenkette wird immer in ihrer kanonischen Großschreibweise angegeben. Einige Beispiele für gültige Werte von
country
:"US"
,"GB"
,"CN"
oder"JP"
. ContactAddress.city
Schreibgeschützt Experimentell-
Eine Zeichenkette, die den Stadt- oder Ortsteil der Adresse enthält.
ContactAddress.dependentLocality
Schreibgeschützt Experimentell-
Eine Zeichenkette, die die abhängige Ortschaft oder Sublokalität innerhalb einer Stadt angibt, zum Beispiel ein Stadtviertel, Bezirk oder UK-abhängige Ortschaft.
ContactAddress.organization
Schreibgeschützt Experimentell-
Eine Zeichenkette, die den Namen der Organisation, Firma, des Unternehmens oder der Institution an der Adresse angibt.
ContactAddress.phone
Schreibgeschützt Experimentell-
Eine Zeichenkette, die die Telefonnummer des Empfängers oder Ansprechpartners angibt.
ContactAddress.postalCode
Schreibgeschützt Experimentell-
Eine Zeichenkette, die einen von einer Gerichtsbarkeit für die Postzustellung verwendeten Code angibt, zum Beispiel die Postleitzahl in den Vereinigten Staaten oder der PIN-Code in Indien.
ContactAddress.recipient
Schreibgeschützt Experimentell-
Eine Zeichenkette, die den Namen des Empfängers, Käufers oder Ansprechpartners an der Adresse angibt.
ContactAddress.region
Schreibgeschützt Experimentell-
Eine Zeichenkette, die die höchste Verwaltungseinheit des Landes enthält, zum Beispiel einen Staat, eine Provinz, ein Oblast oder eine Präfektur.
ContactAddress.sortingCode
Schreibgeschützt Experimentell-
Eine Zeichenkette, die einen Postsortiercode wie in Frankreich verwendet bereitstellt.
Instanz-Methoden
ContactAddress.toJSON()
Experimentell-
Ein standardisierter Serializer, der eine JSON-Darstellung der Eigenschaften des
ContactAddress
Objekts zurückgibt.
Beispiele
Das folgende Beispiel fordert den Benutzer auf, Kontakte auszuwählen, und gibt dann die erste zurückgegebene Adresse in der Konsole aus.
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.
}
}
Spezifikationen
Specification |
---|
Contact Picker API # contactaddress |
Browser-Kompatibilität
BCD tables only load in the browser