Kontakt

Enthält Eigenschaften, die einen Kontakt, z. B. eines Benutzers persönlicher oder geschäftlicher Kontakt zu beschreiben.

Eigenschaften

  • ID: einen globally unique Identifier. (DOM-String und enthält)

  • DisplayName: der Name dieses Kontakts, geeignet für die Anzeige an Endverbraucher. (DOM-String und enthält)

  • Name: ein Objekt, das alle Komponenten eines Personen-Namen enthält. (Kontaktperson)

  • Nickname: einen lässig ein, um den Kontakt zu adressieren. (DOM-String und enthält)

  • Telefonnummern: ein Array von der Kontakt-Telefonnummern. (ContactField[])

  • Email: ein Array von e-Mail-Adressen des Kontakts. (ContactField[])

  • Adressen: ein Array von allen Kontaktadressen. (ContactAddress[])

  • IMS: ein Array von IM-Adressen des Kontakts. (ContactField[])

  • Organisationen: ein Array von Organisationen des Kontakts. (ContactOrganization[])

  • Geburtstag: der Geburtstag des Kontakts. (Datum)

  • Anmerkung: eine Anmerkung über den Kontakt. (DOM-String und enthält)

  • Fotos: ein Array mit den Kontakt-Fotos. (ContactField[])

  • Kategorien: ein Array mit allen benutzerdefinierten Kategorien zugeordnet den Kontakt. (ContactField[])

  • URLs: ein Array von Web-Seiten, die den Kontakt zugeordnet. (ContactField[])

Methoden

  • Klon: gibt eine neue Contact Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der id -Eigenschaft festgelegtnull.

  • Entfernen: entfernt den Kontakt aus der Gerät-Kontakte-Datenbank, ansonsten führt eine Fehler-Callback mit einem [ContactError](../ContactError/contactError.html) Objekt.

  • Speichern: speichert einen neuen Kontakt in der Gerätedatenbank Kontakte, oder einen vorhandenen Kontakt aktualisiert, wenn ein Kontakt mit der gleichen Id bereits vorhanden ist.

Informationen

Das Contact -Objekt repräsentiert einen Benutzer Kontakt. Kontakte können erstellt, gespeichert oder aus der Gerät-Kontakte-Datenbank entfernt werden. Kontakte können auch abgerufen werden (einzeln oder als Gruppe) aus der Datenbank durch den Aufruf der [contacts.find](../contacts.find.html) Methode.

Hinweis: Nicht alle oben aufgeführten Kontaktfelder sind auf jedem Geräteplattform unterstützt. Bitte überprüfen Sie jede Plattform Quirks Abschnitt für Details.

Unterstützte Plattformen

  • Android
  • BlackBerry WebWorks (OS 5.0 und höher)
  • iOS
  • Windows Phone 7 und 8
  • Windows 8

Kleines Beispiel zu speichern

function onSuccess(contact) {
    alert("Save Success");
};

function onError(contactError) {
    alert("Error = " + contactError.code);
};

// create a new contact object
var contact = navigator.contacts.create();
contact.displayName = "Plumber";
contact.nickname = "Plumber";            // specify both to support all devices

// populate some fields
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
contact.name = name;

// save to device
contact.save(onSuccess,onError);

Kleines Beispiel zu klonen

    // clone the contact object
    var clone = contact.clone();
    clone.name.givenName = "John";
    console.log("Original contact name = " + contact.name.givenName);
    console.log("Cloned contact name = " + clone.name.givenName);

Kleines Beispiel zu entfernen

function onSuccess() {
    alert("Removal Success");
};

function onError(contactError) {
    alert("Error = " + contactError.code);
};

    // remove the contact from the device
    contact.remove(onSuccess,onError);

Vollständiges Beispiel

<!DOCTYPE html>
<html>
  <head>
    <title>Contact Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // create
        var contact = navigator.contacts.create();
        contact.displayName = "Plumber";
        contact.nickname = "Plumber";                 // specify both to support all devices
        var name = new ContactName();
        name.givenName = "Jane";
        name.familyName = "Doe";
        contact.name = name;

        // save
        contact.save(onSaveSuccess,onSaveError);

        // clone
        var clone = contact.clone();
        clone.name.givenName = "John";
        console.log("Original contact name = " + contact.name.givenName);
        console.log("Cloned contact name = " + clone.name.givenName);

        // remove
        contact.remove(onRemoveSuccess,onRemoveError);
    }

    // onSaveSuccess: Get a snapshot of the current contacts
    //
    function onSaveSuccess(contact) {
        alert("Save Success");
    }

    // onSaveError: Failed to get the contacts
    //
    function onSaveError(contactError) {
        alert("Error = " + contactError.code);
    }

    // onRemoveSuccess: Get a snapshot of the current contacts
    //
    function onRemoveSuccess(contacts) {
        alert("Removal Success");
    }

    // onRemoveError: Failed to get the contacts
    //
    function onRemoveError(contactError) {
        alert("Error = " + contactError.code);
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Android 2.X Macken

  • Kategorien: Android 2.X Geräten, Rückgabe nicht unterstütztnull.

BlackBerry WebWorks (OS 5.0 und höher) Macken

  • ID: unterstützt. Durch das Gerät zugewiesen, wenn Sie den Kontakt zu speichern.

  • DisplayName: unterstützt. Im BlackBerry user1 Feld gespeichert.

  • Nickname: nicht unterstützt, Rückgabenull.

  • Telefonnummern: teilweise unterstützt. Telefonnummern werden im BlackBerry Felder homePhone1 und homePhone2 gespeichert, wenn Typ "zu Hause", workPhone1 und workPhone2 wenn Typ 'Arbeit', MobilePhone wenn Typ 'mobile' ist, FaxPhone wenn Typ 'Fax', PagerPhone ist wenn Typ ist "Pager" und wollte , wenn keines der obigen ist .

  • Email: teilweise unterstützt. Die ersten drei e-Mail-Adressen werden in die BlackBerry- mail1, e-mail2und email3 Felder, bzw. gespeichert.

  • Adressen: teilweise unterstützt. Die erste und zweite Adresse werden bzw. in die Felder HomeAddress und WorkAddress BlackBerry gespeichert.

  • IMS: nicht unterstützt, Rückgabenull.

  • Organisationen: teilweise unterstützt. Den Namen und den Titel der ersten Organisation werden in den Feldern Firma und Titel BlackBerry gespeichert.

  • Fotos: teilweise unterstützt. Ein einzelnes Foto der Miniaturansicht wird unterstützt. Legen Sie ein Kontakt-Foto, übergeben in einem entweder eine base64-codierte Bild oder eine URL auf das Bild zeigen. Das Bild wird vor dem Speichern der BlackBerry Kontakte Datenbank verkleinert. Kontakte Foto wird als base64-codierte Bild zurückgegeben.

  • Kategorien: teilweise unterstützt. Nur die Kategorien Business und Personal werden unterstützt.

  • URLs: teilweise unterstützt. Die erste URL wird in BlackBerry Webseite Feld gespeichert.

iOS Macken

  • DisplayName: nicht auf iOS, Rückkehr unterstützt null es sei kein [ContactName](../ContactName/contactname.html) angegeben, in welchem Fall es gibt den zusammengesetzten Namen, Spitznamen oder "" bzw..

  • Geburtstag: muss eingegeben werden, als JavaScript Date Objekt, die gleiche Weise zurückgegeben wird.

  • Fotos: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist. Inhalt des temporären Verzeichnisses werden entfernt, wenn die Anwendung beendet wird.

  • Kategorien: Diese Eigenschaft wird derzeit nicht unterstützt, Rückgabenull.

Windows Phone 7 und 8 Macken

  • DisplayName: Wenn Sie einen Kontakt erstellen, der Nutzen für den Anzeigenamen der Display-Name-Parameter unterscheidet abgerufen, wenn den Kontakt zu finden.

  • URLs: Wenn Sie einen Kontakt erstellen, können Benutzer eingegeben und mehrere Web-Adressen zu speichern, aber einzige steht ist verfügbar, wenn den Kontakt zu suchen.

  • Telefonnummern: die Pref -Option wird nicht unterstützt. Der Typ wird in eine find -Operation nicht unterstützt. Nur ein phoneNumber ist erlaubt für jeden Typ.

  • Email: Pref -Option wird nicht unterstützt. Haus und persönliche verweist auf dasselbe e-Mail-Eintrag. Nur ein Eintrag ist für jeden Typ zulässig..

  • Adressen: unterstützt nur Arbeit und Home/persönliche Art. Den gleichen Adresseintrag auf den privaten und persönlichen Typ verweisen. Nur ein Eintrag ist für jeden Typ zulässig..

  • Organisationen: nur zulässig ist, und unterstützt nicht die Attribute Pref, Typund Abteilung .

  • Hinweis: nicht unterstützt, Rückgabenull.

  • IMS: nicht unterstützt, Rückgabenull.

  • Geburtstage: nicht unterstützt, Rückgabenull.

  • Kategorien: nicht unterstützt, Rückgabenull.