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, bevor Sie diese produktiv verwenden.

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 Nur lesbar 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 Nur lesbar 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 Nur lesbar Experimentell

Eine Zeichenkette, die den Stadt- oder Ortsteil der Adresse enthält.

ContactAddress.dependentLocality Nur lesbar 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 Nur lesbar Experimentell

Eine Zeichenkette, die den Namen der Organisation, Firma, des Unternehmens oder der Institution an der Adresse angibt.

ContactAddress.phone Nur lesbar Experimentell

Eine Zeichenkette, die die Telefonnummer des Empfängers oder Ansprechpartners angibt.

ContactAddress.postalCode Nur lesbar 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 Nur lesbar Experimentell

Eine Zeichenkette, die den Namen des Empfängers, Käufers oder Ansprechpartners an der Adresse angibt.

ContactAddress.region Nur lesbar 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 Nur lesbar 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.

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.
  }
}

Spezifikationen

Specification
Contact Picker API
# contactaddress

Browser-Kompatibilität

BCD tables only load in the browser