phonegap api reference - contacts.doc

Upload: yonasmara

Post on 14-Apr-2018

298 views

Category:

Documents


0 download

TRANSCRIPT

  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    1/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    Phonegap API Reference: CONTACTS

    Pengertian

    Obyek Kontak menyediakan akses ke database kontak milik perangkat.

    Catatan privasi yang penting: Pengumpulan dan penggunaan data kontak

    meningkatkan timbulnya masalah privasi yang penting. Kebijakan privasi dari aplikasi

    Anda harus membicarakan tentang bagaimana aplikasi menggunakan data kontak dan

    apakah bisa dibagi dengan pihak lain. Informasi kontak dianggap sensitif karena

    mengungkapkan dengan siapa seseorang itu berkomunikasi. Oleh karena itu, sebagai

    tambahan untuk kebijakan privasi aplikasi Anda, Anda harus mempertimbangkan untuk

    memberikan pemberitahuan yang just-in-time sebelum aplikasi Anda mengakses atau

    menggunakan data kontak (jika sistem operasi perangkat belum melakukannya).Pemberitahuan tersebut harus memberikan informasi yang sama seperti yang disebutkan

    di atas, serta memperoleh izin pengguna (misalnya, dengan menghadirkan pilihan untuk

    OKdan No Thanks). Perhatikan bahwa beberapa pasar aplikasi mungkin memerlukan

    aplikasi Anda untuk memberikan pemberitahuan yang just-in-time dan mendapatkan izin

    dari pengguna sebelum mengakses data kontak. Pengalaman pengguna yang jelas dan

    mudah untuk dipahami seputar penggunaan data kontak akan membantu menghindari

    kebingungan pengguna dan penyalahgunaan data kontak.

    Methods

    contacts.create contacts.find

    Arguments

    contactFields

    contactSuccess

    contactError

    contactFindOptions

    Objects

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFieldshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactSuccesshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFieldshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactSuccesshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFindOptionshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contact
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    2/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    Contact

    ContactName

    ContactField

    ContactAddress

    ContactOrganization

    ContactFindOptions

    ContactError

    Mengakses Fitur

    Pada versi 3.0, Cordova menerapkan device-level API sebagai plugin. Gunakan

    perintah plugin CLI, dijelaskan dalam The Command-line interface , untuk menambahatau menghapus fitur ini untuk sebuah proyek:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git

    $ cordova plugin rm org.apache.cordova.core.contacts

    Perintah ini berlaku untuk semua platform yang ditargetkan, namun memodifikasi

    pengaturanplatform-spesific configuration dijelaskan di bawah ini:

    Android

    (in app/res/xml/config.xml)

    (in app/AndroidManifest.xml)

    BlackBerry WebWorks

    (in www/plugins.xml)

    (in www/config.xml)

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactNamehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactAddresshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactOrganizationhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23The%2520Command-line%250AInterface#The%20Command-line%0AInterfacehttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23The%2520Command-line%250AInterface#The%20Command-line%0AInterfacehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactNamehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactAddresshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactOrganizationhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23The%2520Command-line%250AInterface#The%20Command-line%0AInterfacehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contact
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    3/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    iOS (dalam config.xml)

    Windows Phone

    (inProperties/WPAppManifest.xml)

    Beberapa platform mungkin mendukung fitur ini tanpa memerlukan konfigurasi khusus.

    contacts.create

    Mengembalikan/menghasilkan objek Contact yang baru.

    var contact = navigator.contacts.create(properties);

    Deskripsi

    Method contacts.create itu synchronous, dan mengembalikan objek Contact yang baru.Method ini tidak mempertahankan objek Contact dalam database kontak perangkat,

    untuk itu Anda butuh memanggil method C ontacts.sav e.

    Platform yang didukung

    Android

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Contoh Cepat

    var myContact = navigator.contacts.create({"displayName": "Test User"});

    Contoh Lengkap

    Contact Example

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.create#contacts.createhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.create#contacts.createhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.create#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.create#contacts.createhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.create#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contact
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    4/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    // Wait for device API libraries to load

    //

    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available

    //

    function onDeviceReady() {

    var myContact = navigator.contacts.create({"displayName": "Test User"});

    myContact.note = "This contact has a note.";

    console.log("The contact, " + myContact.displayName + ", note: " + myContact.note);

    }

    Example

    Create Contact

    contacts.find

    Melakukan query terhadap database kontak perangkat dan mengembalikan satu atau

    lebih obyek Contact, masing-masing berisi field yang ditentukan.

    navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);

    Deskripsi

    Method contacts.findmengeksekusi secara asynchronous, melakukan query ke database

    kontak perangkat dan mengembalikan sebuah array dari obyek Contact. Obyek-obyek

    yang dihasilkan diteruskan ke fungsi callback contactSuccess yang ditentukan oleh

    parameter contactSuccess.

    Parameter contactFields menentukan field yang akan digunakan sebagai kualifikasi

    pencarian, dan hanya hasil tersebut yang dilewatkan ke fungsi callbackcontactSuccess.

    Sebuah parameter contactFields yang zero-length tidaklah valid dan hasilnya pada

    ContactError.INVALID_ARGUMENT_ERROR. Sebuah contactFields dengan nilai "*" akan

    mengembalikan semua field kontak.

    String contactFindOptions.filter dapat digunakan sebagai filter pencarian ketika

    melakukan query ke database kontak. Jika diberikan, case-senstitive, kecocokan nilai

    parsial diterapkan untuk masing-masing field yang ditentukan dalam parameter

    contactFields. Jika ada kecocokan untuk salah satu field tertentu, maka kontak

    dikembalikan.

    Parameter

    http://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFieldshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactSuccesshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFindOptionshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.find#contacts.findhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.find#contacts.findhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactSuccess#contactSuccesshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactSuccess#contactSuccesshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactSuccess#contactSuccesshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactFields#contactFieldshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactSuccess#contactSuccesshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactFields#contactFieldshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactFields#contactFieldshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactFields#contactFieldshttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFieldshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactSuccesshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactFindOptionshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.find#contacts.findhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactSuccess#contactSuccesshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactSuccess#contactSuccesshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactFields#contactFieldshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactSuccess#contactSuccesshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactFields#contactFieldshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactFields#contactFields
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    5/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    contactFields : Field Contact untuk digunakan sebagai kualifikasi pencarian. Objek

    Contact Yang dihasilkan hanyalah nilai fitur untuk field ini. (DOMString[])

    [Diperlukan]

    contactSuccess : Fungsi callback sukses dipanggil dengan kontak yang

    dikembalikan dari database. [Diperlukan]

    contactError : Fungsi callbackerror

    , dipanggil saat terjadi kesalahan. [Opsional]

    contactFindOptions : Pilihan pencarian ke kontak filter. [Opsional]

    Platform yang didukung

    Android

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Windows 8

    Contoh Cepat

    function onSuccess(contacts) {

    alert('Found ' + contacts.length + ' contacts.');

    };

    function onError(contactError) {

    alert('onError!');

    };

    // find all contacts with 'Bob' in any name field

    var options = newContactFindOptions();

    options.filter = "Bob";

    options.multiple = true;

    var fields = ["displayName", "name"];

    navigator.contacts.find(fields, onSuccess, onError, options);

    Contoh Lengkap

    Contact Example

    // Wait for device API libraries to load

    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available

    function onDeviceReady() {

    // find all contacts with 'Bob' in any name field

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#deviceready
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    6/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    var options = newContactFindOptions();

    options.filter = "Bob";

    var fields = ["displayName", "name"];

    navigator.contacts.find(fields, onSuccess, onError, options);

    }

    // onSuccess: Get a snapshot of the current contacts

    function onSuccess(contacts) {

    for (var i = 0; i < contacts.length; i++) {

    console.log("Display Name = " + contacts[i].displayName);

    }

    }

    // onError: Failed to get the contacts

    function onError(contactError) {

    alert('onError!');

    }

    Example

    Find Contacts

    Contact

    Berisi properti yang menggambarkan kontak, seperti info pribadi pengguna atau kontak

    bisnis.

    Properti

    id: Sebuah pengenal yang unik secara global. (DOMString)

    displayName: Nama dari Contact ini, cocok untuk tampilan ke end-user.

    (DOMString)

    name: Sebuah obyek yang mengandung semua komponen dari nama seseorang.

    (ContactName)

    nickname: Sebuah nama kasual yang digunakan untuk mengatasi kontak.

    (DOMString)

    phoneNumbers: Sebuah array dari semua nomor telepon kontak.

    (ContactField[])

    email: Sebuah array dari semua alamat email kontak. (ContactField[])

    addresses: Sebuah array dari semua alamat kontak. (ContactAddress[])

    ims: Sebuah array dari semua alamat IM kontak. (ContactField[])

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactName#ContactNamehttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddresshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactName#ContactNamehttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddresshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactField
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    7/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    organizations: Sebuah array dari semua organisasi kontak.

    (ContactOrganization[])

    birthday: Birthday kontak. (Date)

    note: Sebuah catatan tentang kontak. (DOMString)

    photos: Sebuah array foto kontak. (ContactField[])

    categories: Sebuah array dari semua kategori user-defined berhubungan dengan

    kontak tersebut. (ContactField[])

    url: Array halaman web yang berhubungan dengan kontak tersebut.

    (ContactField[])

    Metode

    clone: Mengembalikan objek Contact baru yang merupakan salinan mendalam

    dari obyek yang memanggil, dengan properti id diatur ke nol. remove: Menghapus kontak dari database kontak perangkat, jika tidak,

    menjalankan sebuah error callbackdengan objekContactError.

    save: Menyimpan kontak baru ke database kontak perangkat, atau update kontak

    yang ada jika kontak dengan id yang sama sudah ada.

    Detail

    Objek Contact merepresentasikan kontak pengguna. Contacts dapat dibuat, disimpan,

    atau dihapus dari database kontak perangkat. Contacts juga dapat diambil (secara

    individu atau secara massal) dari database dengan menerapkan method contacts.find.

    CATATAN: Tidak semua field kontak yang tercantum di atas didukung pada setiap

    platform perangkat.

    Platform yang didukung

    Android

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Windows 8

    Contoh Cepat Save

    function onSuccess(contact) {

    alert("Save Success");

    };

    function onError(contactError) {

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

    // create a new contact object

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.find#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contacts.find#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactError
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    8/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    var contact = navigator.contacts.create();

    contact.displayName = "Plumber";

    contact.nickname = "Plumber"; // specify both to support all devices

    // populate some fields

    var name = newContactName();

    name.givenName = "Jane";

    name.familyName = "Doe";

    contact.name = name;

    // save to device

    contact.save(onSuccess,onError);

    Contoh Cepat Clone

    // 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);

    Contoh Cepat Remove

    function onSuccess() {

    alert("Removal Success");

    };

    function onError(contactError) {

    alert("Error = " + contactError.code);

    };

    // remove the contact from the device

    contact.remove(onSuccess,onError);

    Contoh Lengkap

    Contact Example

    // 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 = newContactName();

    name.givenName = "Jane";

    name.familyName = "Doe";

    contact.name = name;

    // save

    contact.save(onSaveSuccess,onSaveError);

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactNamehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactNamehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactNamehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactName
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    9/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    // 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);

    }

    Example

    Find Contacts

    Android 2.X Quirks

    categories: Not supported pada perangkat Android 2.X, mengembalikan null.

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi) quirks

    id: Supported. Ditugaskan oleh perangkat saat menyimpan kontak.

    displayName: Supported. Disimpan dalam filed user1 BlackBerry.

    nickname: Not supported, mengembalikan null.

    phonenumbers: Partially supported. Nomor telepon disimpan di field

    homePhone1 dan homePhone2 Blackberry jika type adalah 'home',

    workPhone1 dan workPhone2 jika type adalah 'work', mobilePhone jika type

    adalah 'mobile', faxPhone jika type adalah 'fax', pagerPhone jika type adalah

    'pager', dan otherPhone jika type tidak ada di atas.

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacts
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    10/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    email: Partially supported. Tiga alamat email pertama disimpan dalam BlackBerry

    email1,email2, dan email3 bidang, masing-masing.

    addresses: Partially supported. Alamat pertama dan kedua disimpan dalam field

    homeAddress dan workAddress BlackBerry, masing-masing.

    ims: Not supported, mengembalikan null.

    organization: Partially supported. nama dan judul dari organisasi pertama

    disimpan dalam field BlackBerry company dan title, masing-masing.

    photos: Partially supported. Sebuah foto tunggal berukuran thumbnail

    didukung. Untuk mengatur foto kontak, lolos baik pada gambar base64-encoded,

    atau URL yang menunjuk ke gambar. Gambar diperkecil sebelum menyimpannya

    ke database kontak BlackBerry. Foto kontak dikembalikan sebagai gambar

    base64-encoded.

    categories: Partially supported. Hanya kategori Business dan Personal yang

    didukung.

    url: Partially supported. URL yang pertama disimpan di field webpage

    BlackBerry.

    iOS quirks

    displayName: Not supported pada IOS, mengembalikan null kecuali jika tidak

    ada ContactName yang ditentukan, dalam hal ini mengembalikan nama komposit,

    nickname atau "", masing-masing.

    birthday: Inputan yang harus ada sebagai obyek Date dari JavaScript, dengan

    cara yang sama itu dikembalikan.

    photos: Mengembalikan sebuah File URL ke gambar, yang disimpan dalam

    temporary directory aplikasi. Isi temporary directory dihapus ketika keluar dari

    aplikasi.

    categories: Properti ini saat ini tidak didukung, mengembalikan null.

    Windows Phone 7 dan 8 quirks

    displayName: Ketika membuat kontak, nilai yang diberikan untuk parameter

    display name berbeda dari yang display name diambil ketika menemukan kontak. url: Ketika membuat kontak, pengguna dapat memasukkan dan menyimpan lebih

    dari satu alamat web, tetapi hanya satu yang tersedia tersedia ketika mencari

    kontak.

    phonenumbers: Pilihan pref tidak didukung. type tidak didukung dalam operasi

    find. Hanya satu phoneNumber yang diperbolehkan untuk masing-masing type.

    email: Pilihanpreftidak didukung. Home dan Personal merujuk pada entri email

    yang sama. Hanya satu entri diperbolehkan untuk masing-masing type.

    addresses: Mendukung hanya type work, dan home/personal.type Home dan

    Personal merujuk pada entri alamat yang sama. Hanya satu entri diperbolehkanuntuk masing-masing type.

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactName#ContactNamehttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_file_file.md.html%23File#Filehttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_file_file.md.html%23File#Filehttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactName#ContactNamehttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_file_file.md.html%23File#File
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    11/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    organizations: Hanya satu yang diperbolehkan, dan tidak mendukung atribut

    pref,type, dan department.

    note: Not supported, mengembalikan null.

    ims: Not supported, mengembalikan null.

    birthday: Not supported, mengembalikan null.

    categories: Not supported, mengembalikan null.

    ContactAddress

    Berisi properti alamat untuk objek Contact.

    Properti

    pref: Diatur ke true jika ContactAddress ini berisi nilai yang lebih disukai

    pengguna. (boolean)

    type: Sebuah string yang menunjukkan apa jenis dari suatu field, home misalnya.

    (DOMString)

    formatted: Alamat lengkap yang diformat untuk ditampilkan. (DOMString)

    StreetAddress: Alamat jalan secara penuh. (DOMString)

    locality: Kota atau locality. (DOMString)

    region: Negara atau wilayah. (DOMString)

    postalCode: Kode pos. (DOMString)

    country: Nama negara. (DOMString)

    Detail

    Obyek ContactAddress menyimpan properti dari alamat tunggal suatu kontak. Obyek

    Contact dapat mencakup lebih dari satu alamat dalam array ContactAddress[].

    Platform yang didukung

    Android

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Windows 8

    Contoh Cepat

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddresshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddresshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddresshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddresshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddresshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactAddress#ContactAddress
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    12/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    // display the address information for all contacts

    function onSuccess(contacts) {

    for (var i = 0; i < contacts.length; i++) {

    for (var j = 0; j < contacts[i].addresses.length; j++) {

    alert("Pref: " + contacts[i].addresses[j].pref + "\n" +

    "type: " + contacts[i].addresses[j].type + "\n" +

    "Formatted: " + contacts[i].addresses[j].formatted + "\n" +

    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" + "Locality: " + contacts[i].addresses[j].locality + "\n" +

    "Region: " + contacts[i].addresses[j].region + "\n" +

    "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +

    "Country: " + contacts[i].addresses[j].country);

    }

    }

    };

    function onError(contactError) {

    alert('onError!');

    };

    // find all contactsvar options = newContactFindOptions();

    options.filter = "";

    var filter = ["displayName", "addresses"];

    navigator.contacts.find(filter, onSuccess, onError, options);

    Contoh Lengkap

    Contact Example

    // Wait for device API libraries to load

    //

    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available

    //

    function onDeviceReady() {

    // find all contacts

    var options = newContactFindOptions();

    options.filter = "";

    var filter = ["displayName", "addresses"];

    navigator.contacts.find(filter, onSuccess, onError, options);

    }

    // onSuccess: Get a snapshot of the current contacts

    //

    function onSuccess(contacts) {

    // display the address information for all contacts

    for (var i = 0; i < contacts.length; i++) {

    for (var j = 0; j < contacts[i].addresses.length; j++) {

    alert("Pref: " + contacts[i].addresses[j].pref + "\n"

    +

    "type: " + contacts[i].addresses[j].type + "\n"

    +

    "Formatted: " + contacts[i].addresses[j].formatted + "\n"+

    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n"

    +

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.find
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    13/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    "Locality: " + contacts[i].addresses[j].locality + "\n"

    +

    "Region: " + contacts[i].addresses[j].region + "\n"

    +

    "Postal Code: " + contacts[i].addresses[j].postalCode + "\n"

    +

    "Country: " + contacts[i].addresses[j].country);

    }

    }};

    // onError: Failed to get the contacts

    //

    function onError(contactError) {

    alert('onError!');

    }

    Example

    Find Contacts

    Android 2.X quirks

    pref: Not supported, mengembalikan false pada perangkat Android 2.X.

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi) quirks

    pref: Not supported pada perangkat BlackBerry, mengembalikan false.

    type: Partially supported. Hanya masing-masing satu dari jenis alamat WorkdanHome dapat disimpan per kontak.

    formatted: Partially supported. Mengembalikan suatu gabungan dari semua field

    alamat BlackBerry.

    StreetAddress: Supported. Mengembalikan suatu gabungan dari field alamat

    address1 dan address2 BlackBerry.

    locality: Supported. Disimpan dalam field alamat city BlackBerry.

    region: didukung. Disimpan dalam field alamat stateProvince BlackBerry.

    postalCode: Supported. Disimpan dalam field alamat zipPostal BlackBerry.

    country: Supported.

    iOS quirks

    pref: Not supported pada perangkat iOS, mengembalikan false.

    formatted: Saat ini tidak didukung.

    ContactField

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacts
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    14/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    Mendukung field generik pada obyek Contact. Beberapa properti disimpan sebagai obyek

    ContactField termasuk alamat email, nomor telepon, dan URL.

    Properti

    type: Sebuah string yang menunjukkan apa jenis dari field ini, home misalnya.

    (DOMString) Nilai: Nilai dari field, seperti nomor telepon atau alamat email. (DOMString)

    pref: Diatur ke true jika ContactField ini berisi nilai yang cenderung disukai

    pengguna. (boolean)

    Detail

    Obyek ContactField adalah komponen yang dapat digunakan kembali yang

    merepresentasikan field kontak secara umum. Masing-masing obyek ContactField berisi

    propert value, type, dan pref. Obyek Contact menyimpan beberapa properti pada array

    ContactField[], seperti nomor telepon dan alamat email.

    Dalam kebanyakan kasus, tidak ada nilai-nilai yang telah ditentukan untuk atribut type

    dari obyek ContactField. Sebagai contoh, nomor telepon dapat menentukan nilai type

    home,work,mobile,iPhone, atau nilai lain yang didukung oleh database kontak platform

    perangkat tertentu. Namun, untuk field photos dari Contact, field type menunjukkan

    format dari gambar yang dikembalikan: url ketika atribut value berisi URL ke gambar

    foto, atau base64 ketika value berisi string gambar base64-encoded.

    Platform yang didukung

    Android BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Windows 8

    Contoh Cepat

    // create a new contact

    var contact = navigator.contacts.create();

    // store contact phone numbers in ContactField[]

    var phoneNumbers = [];

    phoneNumbers[0] = newContactField('work', '212-555-1234', false);

    phoneNumbers[1] = newContactField('mobile', '917-555-5432', true); // preferred

    number

    phoneNumbers[2] = newContactField('home', '203-555-7890', false);

    contact.phoneNumbers = phoneNumbers;

    // save the contact

    contact.save();

    Contoh Lengkap

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactField#ContactFieldhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactField
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    15/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    Contact Example

    // Wait for device API libraries to load //

    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available

    //

    function onDeviceReady() {

    // create a new contact

    var contact = navigator.contacts.create();

    // store contact phone numbers in ContactField[]

    var phoneNumbers = [];

    phoneNumbers[0] = newContactField('work', '212-555-1234', false);phoneNumbers[1] = newContactField('mobile', '917-555-5432', true); // preferred

    number

    phoneNumbers[2] = newContactField('home', '203-555-7890', false);

    contact.phoneNumbers = phoneNumbers;

    // save the contact

    contact.save();

    // search contacts, returning display name and phone numbers

    var options = newContactFindOptions();

    options.filter = "";

    filter = ["displayName", "phoneNumbers"];

    navigator.contacts.find(filter, onSuccess, onError, options);

    }

    // onSuccess: Get a snapshot of the current contacts

    //

    function onSuccess(contacts) {

    for (var i = 0; i < contacts.length; i++) {

    // display phone numbers

    for (var j = 0; j < contacts[i].phoneNumbers.length; j++) {

    alert("Type: " + contacts[i].phoneNumbers[j].type + "\n" +

    "Value: " + contacts[i].phoneNumbers[j].value + "\n" +

    "Preferred: " + contacts[i].phoneNumbers[j].pref);

    }

    }

    };

    // onError: Failed to get the contacts

    //

    function onError(contactError) {

    alert('onError!');

    }

    Example

    Find Contacts

    Android Quirks

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.createhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFieldhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacts
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    16/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    pref: Not supported, mengembalikan false.

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi) quirks

    type: Partially supported. Digunakan untuk nomor telepon.

    Nilai: Supported.

    pref: Not supported, mengembalikan false.

    iOS quirks

    pref: Not supported, mengembalikan false.

    ContactFindOptions

    Berisi properti yang dapat digunakan untuk menyaring hasil operasi contacts.find.

    Properti

    filter: String pencarian yang digunakan untuk mencari kontak. (DOMString)

    (Default: "")

    multiple: Menentukan apakah operasi find mengembalikan beberapa kontak.

    (boolean) (Default: false)

    Platform yang Didukung

    Android

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Windows 8

    Contoh Cepat

    // success callback

    function onSuccess(contacts) {

    for (var i=0; i

  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    17/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    // find contacts

    navigator.contacts.find(filter, onSuccess, onError, options);

    Contoh Lengkap

    Contact Example

    // Wait for device API libraries to load

    //

    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available

    //

    function onDeviceReady() {

    // specify contact search criteria

    var options = newContactFindOptions();

    options.filter = ""; // empty search string returns all contacts

    options.multiple = true; // return multiple results

    filter = ["displayName"]; // return contact.displayName field

    // find contacts

    navigator.contacts.find(filter, onSuccess, onError, options);

    }

    // onSuccess: Get a snapshot of the current contacts

    //

    function onSuccess(contacts) {

    for (var i=0; i

  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    18/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    formatted: Nama lengkap kontak. (DOMString)

    familyName: Nama keluarga kontak. (DOMString)

    givenName: Nama yang diberikan untuk kontak. (DOMString)

    middleName: Nama tengah kontak. (DOMString)

    honorificPrefix: Gelar di depan kontak (misalnya Mr. atau Dr.)(DOMString)

    honorificSuffix: Gelar di belakang kontak (misalnya Esq.).(DOMString)

    Detail

    Obyek ContactName menyimpan properti dari nama suatu kontak.

    Platform yang Didukung

    Android 2.X

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Windows 8

    Contoh Cepat

    function onSuccess(contacts) {

    for (var i = 0; i < contacts.length; i++) {alert("Formatted: " + contacts[i].name.formatted + "\n" +

    "Family Name: " + contacts[i].name.familyName + "\n" +

    "Given Name: " + contacts[i].name.givenName + "\n" +

    "Middle Name: " + contacts[i].name.middleName + "\n" +

    "Suffix: " + contacts[i].name.honorificSuffix + "\n" +

    "Prefix: " + contacts[i].name.honorificSuffix);

    }

    };

    function onError(contactError) {

    alert('onError!');

    };

    var options = newContactFindOptions();

    options.filter = "";

    filter = ["displayName", "name"];

    navigator.contacts.find(filter, onSuccess, onError, options);

    Contoh Lengkap

    Contact Example

    // Wait for device API libraries to load

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactName#ContactNamehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactName#ContactNamehttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contact
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    19/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    //

    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available

    //

    function onDeviceReady() {

    var options = newContactFindOptions();

    options.filter="";

    filter = ["displayName","name"];navigator.contacts.find(filter, onSuccess, onError, options);

    }

    // onSuccess: Get a snapshot of the current contacts

    //

    function onSuccess(contacts) {

    for (var i = 0; i < contacts.length; i ++) {

    alert("Formatted: " + contacts[i].name.formatted + "\n" +

    "Family Name: " + contacts[i].name.familyName + "\n" +

    "Given Name: " + contacts[i].name.givenName + "\n" +

    "Middle Name: " + contacts[i].name.middleName + "\n" +

    "Suffix: " + contacts[i].name.honorificSuffix + "\n" +

    "Prefix: " + contacts[i].name.honorificPrefix);}

    };

    // onError: Failed to get the contacts

    //

    function onError(contactError) {

    alert('onError!');

    }

    Example

    Find Contacts

    Android Quirks

    formatted: Partially supported, dan read-only. Mengembalikan suatu gabungan

    dari honorificPrefix, givenName, middleName, familyName, dan honorificSuffix.

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi) quirks

    formatted: Partially supported. Mengembalikan suatu gabungan dari fieldfirstName dan lastName BlackBerry.

    familyName: Supported. Disimpan dalam field lastName BlackBerry.

    givenName: Supported. Disimpan dalam field firstName BlackBerry.

    middleName: Not supported, mengembalikan null.

    honorificPrefix: Not supported, mengembalikan null.

    honorificSuffix: Not supported, mengembalikan null.

    iOS quirks

    http://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacts
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    20/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    formatted: Partially supported. Mengembalikan Composite Name iOS, tetapi

    read-only.

    ContactOrganization

    Berisi properti organisasi dari obyekContact.

    Properti

    pref: Diatur ke true jika ContactOrganization ini berisi nilai yang cenderung lebih

    disukai pengguna. (boolean)

    type: Sebuah string yang menunjukkan apa jenis dari field ini, home misalnya. _

    (DOMString)

    name: Nama organisasi. (DOMString)

    department: Departemen dimana kontak bekerja. (DOMString)

    title: Judul kontak di organisasi itu. (DOMString)

    Detail

    Obyek ContactOrganization menyimpan properti organisasi dari suatu kontak. Sebuah

    obyek Contact menyimpan satu atau lebih objek ContactOrganization dalam array.

    Platform yang Didukung

    Android

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi)

    iOS

    Windows Phone 7 dan 8

    Windows 8

    Contoh Cepat

    function onSuccess(contacts) {

    for (var i = 0; i < contacts.length; i++) {

    for (var j = 0; j < contacts[i].organizations.length; j++) {

    alert("Pref: " + contacts[i].organizations[j].pref + "\n" +

    "Type: " + contacts[i].organizations[j].type + "\n" +

    "Name: " + contacts[i].organizations[j].name + "\n" +

    "Department: " + contacts[i].organizations[j].department + "\n" +

    "Title: " + contacts[i].organizations[j].title);

    }

    }

    };

    function onError(contactError) {

    alert('onError!');};

    var options = newContactFindOptions();

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23Contact#Contacthttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactOrganization#ContactOrganizationhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptions
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    21/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    options.filter = "";

    filter = ["displayName", "organizations"];

    navigator.contacts.find(filter, onSuccess, onError, options);

    Contoh Lengkap

    Contact Example

    // Wait for device API libraries to load

    //

    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available

    //

    function onDeviceReady() {

    var options = newContactFindOptions();

    options.filter="";

    filter = ["displayName","organizations"];

    navigator.contacts.find(filter, onSuccess, onError, options);

    }

    // onSuccess: Get a snapshot of the current contacts

    //

    function onSuccess(contacts) {

    for (var i = 0; i < contacts.length; i++) {

    for (var j = 0; j < contacts[i].organizations.length; j++) {

    alert("Pref: " + contacts[i].organizations[j].pref + "\n" +

    "Type: " + contacts[i].organizations[j].type + "\n" +

    "Name: " + contacts[i].organizations[j].name + "\n" + "Department: " + contacts[i].organizations[j].department + "\n" +

    "Title: " + contacts[i].organizations[j].title);

    }

    }

    };

    // onError: Failed to get the contacts

    //

    function onError(contactError) {

    alert('onError!');

    }

    Example

    Find Contacts

    Android 2.X quirks

    pref: Not supported oleh perangkat Android 2.X, mengembalikan false.

    BlackBerry WebWorks (OS 5.0 dan lebih tinggi) quirks

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contactshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacthttp://docs.phonegap.com/en/3.0.0/cordova_inappbrowser_inappbrowser.md.html#addEventListenerhttp://docs.phonegap.com/en/3.0.0/cordova_events_events.md.html#devicereadyhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#ContactFindOptionshttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contacts.findhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#contactErrorhttp://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacts
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    22/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    pref: Not supported oleh perangkat BlackBerry, mengembalikan false.

    type: Not supported oleh perangkat BlackBerry, mengembalikan null.

    name: Partially supported. Nama organisasi yang pertama disimpan dalam field

    company BlackBerry.

    department: Not supported, mengembalikan null.

    title: Partially supported. Judul organisasi yang pertama disimpan dalam field

    jobTitle BlackBerry.

    iOS quirks

    pref: Not supported pada perangkat iOS, mengembalikan false.

    type: Not supported pada perangkat iOS, mengembalikan null.

    name: Partially supported. Nama organisasi yang pertama disimpan di field

    kABPersonOrganizationProperty iOS.

    department: Partially supported. Nama departemen yang pertama disimpan di

    field kABPersonDepartmentProperty iOS.

    title: Partially supported. Judul yang pertama disimpan di field

    kABPersonJobTitleProperty iOS.

    ContactError

    Obyek ContactError akan diteruskan ke callback contactError ketika terjadi kesalahan.

    Properti

    code: Salah satu kode kesalahan standar yang tercantum di bawah ini.

    Konstanta

    ContactError UNKNOWN_ERROR.

    ContactError INVALID_ARGUMENT_ERROR.

    ContactErrorTIMEOUT_ERROR.

    ContactError PENDING_OPERATION_ERROR.

    ContactError IO_ERROR.

    ContactError NOT_SUPPORTED_ERROR.

    ContactError PERMISSION_DENIED_ERROR.

    Deskripsi

    Obyek ContactErrordikembalikan ke pengguna melalui fungsi callback contactError bila

    terjadi kesalahan.

    http://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactError#contactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactError#contactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactError#contactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23ContactError#ContactErrorhttp://translate.google.com/translate?hl=id&prev=_t&sl=en&tl=id&u=http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html%23contactError#contactError
  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    23/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    contactSuccess

    Fungsi callback success yang menyediakan array Contact yang dihasilkan dari operasi

    contacts.find.

    function(contacts) {

    // Do something

    }

    Parameter

    Kontak: Array kontak yang dihasilkan dari operasi find. (Contact)

    Contoh

    functioncontactSuccess(contacts) {

    for (var i=0; i

  • 7/27/2019 PhoneGap API Reference - Contacts.doc

    24/24

    Indra Ekaristio P. (105090600111043) - Yonas Asmara (105090600111049)

    filter: String pencarian yang digunakan untuk menyaring kontak. (DOMString)

    (Default: "")

    multiple: Menentukan apkah operasi find mengembalikan beberapa kontak.

    (boolean) (Default: false)

    Berikut ini screenshot dari Contact:

    Sumber:

    PhoneGap* compatible Contacts API Sample: Work with Device Contact

    Database. http://software.intel.com/en-us/articles/phonegap-contacts-work-with-the-

    devices-contact-database

    PhoneGap Documentation: API Reference: Contacts.

    http://docs.phonegap.com/en/3.0.0/cordova_contacts_contacts.md.html#Contacts