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#Contact7/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#Contact7/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#Contact7/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#contactFields7/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#deviceready7/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#ContactField7/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#contactError7/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#ContactName7/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#Contacts7/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#File7/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#ContactAddress7/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.find7/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#Contacts7/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#ContactField7/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#Contacts7/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#Contact7/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#Contacts7/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#ContactFindOptions7/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#Contacts7/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#contactError7/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
Top Related