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.addressLineSchreibgeschü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.countrySchreibgeschü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.citySchreibgeschützt Experimentell-
Eine Zeichenkette, die den Stadt- oder Ortsteil der Adresse enthält.
ContactAddress.dependentLocalitySchreibgeschü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.organizationSchreibgeschützt Experimentell-
Eine Zeichenkette, die den Namen der Organisation, Firma, des Unternehmens oder der Institution an der Adresse angibt.
ContactAddress.phoneSchreibgeschützt Experimentell-
Eine Zeichenkette, die die Telefonnummer des Empfängers oder Ansprechpartners angibt.
ContactAddress.postalCodeSchreibgeschü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.recipientSchreibgeschützt Experimentell-
Eine Zeichenkette, die den Namen des Empfängers, Käufers oder Ansprechpartners an der Adresse angibt.
ContactAddress.regionSchreibgeschü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.sortingCodeSchreibgeschü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
ContactAddressObjekts 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
Loading…