Contatto
Contiene proprietà che descrivono un contatto, come il contatto personale o aziendale di un utente.
Proprietà
ID: un identificatore univoco globale. (DOMString)
displayName: il nome di questo contatto, adatto per la visualizzazione a utenti finali. (DOMString)
nome: un oggetto che contiene tutti i componenti di un nome di persone. (ContactName)
Nickname: un nome informale con cui affrontare il contatto. (DOMString)
phoneNumbers: una matrice di numeri di telefono del contatto. (ContactField[])
email: una matrice di indirizzi di posta elettronica del contatto. (ContactField[])
indirizzi: una matrice di indirizzi di contatto. (ContactAddress[])
IMS: una matrice di indirizzi IM tutto il contatto. (ContactField[])
organizzazioni: una matrice di organizzazioni di tutto il contatto. (ContactOrganization[])
compleanno: il compleanno del contatto. (Data)
Nota: una nota sul contatto. (DOMString)
foto: una matrice di foto del contatto. (ContactField[])
categorie: matrice di tutte le categorie definite dall'utente connesso con il contatto. (ContactField[])
URL: matrice di pagine web connesso con il contatto. (ContactField[])
Metodi
clone: restituisce una nuova
Contact
oggetto che è una copia completa dell'oggetto chiamante, con laid
proprietà impostatanull
.rimuovere: rimuove il contatto dal database contatti dispositivo, altrimenti esegue un callback di errore con un
[ContactError](../ContactError/contactError.html)
oggetto.Salva: salva un nuovo contatto nel database di contatti del dispositivo, o aggiorna un contatto esistente se esiste già un contatto con lo stesso id .
Dettagli
Il Contact
oggetto rappresenta il contatto di un utente. Contatti possono essere creati, memorizzati o rimossi dal database di contatti dispositivo. Contatti possono anche essere estratto (singolarmente o in blocco) dal database richiamando il [contacts.find](../contacts.find.html)
metodo.
Nota: Non tutti i campi di contatto sopra elencati sono supportati su ogni piattaforma del dispositivo. Consultare la sezione di stranezze su ogni piattaforma per dettagli.
Piattaforme supportate
- Android
- BlackBerry WebWorks (OS 5.0 e superiori)
- iOS
- Windows Phone 7 e 8
- Windows 8
Salvare rapido esempio
function onSuccess(contact) {
alert("Save Success");
};
function onError(contactError) {
alert("Error = " + contactError.code);
};
// create a new contact object
var contact = navigator.contacts.create();
contact.displayName = "Plumber";
contact.nickname = "Plumber"; // specify both to support all devices
// populate some fields
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
contact.name = name;
// save to device
contact.save(onSuccess,onError);
Clonare rapido esempio
// 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);
Rimuovere rapido esempio
function onSuccess() {
alert("Removal Success");
};
function onError(contactError) {
alert("Error = " + contactError.code);
};
// remove the contact from the device
contact.remove(onSuccess,onError);
Esempio completo
<!DOCTYPE html>
<html>
<head>
<title>Contact Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
document.addEventListener("deviceready", onDeviceReady, false);
// device APIs are available
//
function onDeviceReady() {
// create
var contact = navigator.contacts.create();
contact.displayName = "Plumber";
contact.nickname = "Plumber"; // specify both to support all devices
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
contact.name = name;
// save
contact.save(onSaveSuccess,onSaveError);
// clone
var clone = contact.clone();
clone.name.givenName = "John";
console.log("Original contact name = " + contact.name.givenName);
console.log("Cloned contact name = " + clone.name.givenName);
// remove
contact.remove(onRemoveSuccess,onRemoveError);
}
// onSaveSuccess: Get a snapshot of the current contacts
//
function onSaveSuccess(contact) {
alert("Save Success");
}
// onSaveError: Failed to get the contacts
//
function onSaveError(contactError) {
alert("Error = " + contactError.code);
}
// onRemoveSuccess: Get a snapshot of the current contacts
//
function onRemoveSuccess(contacts) {
alert("Removal Success");
}
// onRemoveError: Failed to get the contacts
//
function onRemoveError(contactError) {
alert("Error = " + contactError.code);
}
</script>
</head>
<body>
<h1>Example</h1>
<p>Find Contacts</p>
</body>
</html>
Stranezze di Android 2. x
- categorie: non è supportato sui dispositivi Android 2. x, restituendo
null
.
Stranezze di blackBerry WebWorks (OS 5.0 e superiori)
ID: supportato. Assegnato dal dispositivo quando si salva il contatto.
displayName: supportato. Archiviato in campo utente1 BlackBerry.
soprannome: non supportato, restituendo
null
.phoneNumbers: parzialmente supportati. Numeri di telefono sono memorizzati in BlackBerry campi homePhone1 e homePhone2 se il tipo è 'casa', workPhone1 e workPhone2 se è di tipo 'lavoro', mobilePhone se tipo è 'mobile', faxPhone se tipo è 'fax', pagerPhone se il tipo è 'pager' e rinominare , se il tipo non è nessuno dei precedenti.
email: parzialmente supportati. I primo tre indirizzi sono memorizzati nei BlackBerry email1, email2, email3 campi e, rispettivamente.
indirizzi: parzialmente supportati. I primi e secondo gli indirizzi vengono memorizzati nei campi BlackBerry homeAddress e workAddress , rispettivamente.
IMS: non supportato, restituendo
null
.organizzazioni: parzialmente supportati. Il nome e il titolo della prima organizzazione vengono memorizzati nei campi azienda e titolo BlackBerry, rispettivamente.
foto: parzialmente supportati. Una singola foto miniatura è supportata. Per impostare la foto di un contatto, passare in un o una codifica base64 immagine, o un URL che punta all'immagine. L'immagine viene ridimensionata verso il basso prima di salvare il database di contatti BlackBerry. Foto contatto viene restituito come un immagine con codifica base64.
categorie: parzialmente supportati. Sono supportate solo le categorie di Business e personali .
URL: parzialmente supportati. Il primo URL viene memorizzato nel campo pagina Web BlackBerry.
iOS stranezze
displayName: non supportata su iOS, tornando
null
se non c'è nessun[ContactName](../ContactName/contactname.html)
specificato, nel qual caso restituisce il nome composito, soprannome o""
, rispettivamente.compleanno: deve essere inserito come un JavaScript
Date
oggetto, allo stesso modo viene restituito.foto: restituisce un URL del File dell'immagine, che viene memorizzato nella directory temporanea dell'applicazione. Contenuto della directory temporanea vengono rimossi quando l'applicazione termina.
categorie: questa proprietà non è attualmente supportata, restituendo
null
.
Windows Phone 7 e 8 stranezze
displayName: quando si crea un contatto, il valore specificato per il parametro del nome di visualizzazione è diverso dal nome visualizzato Estratto quando trovare il contatto.
URL: quando creando un contatto, gli utenti possono inserire e salvare più di un indirizzo web, ma solo uno è disponibile è disponibile durante la ricerca del contatto.
phoneNumbers: non è supportata l'opzione pref . Il tipo non è supportato in un'operazione di trovare . Un solo
phoneNumber
è consentita per ogni tipo.email: non è supportata l'opzione pref . Home e personal fa riferimento la stessa voce di posta elettronica. È consentito un solo ingresso per ogni tipo.
indirizzi: supporta solo lavoro e casa/personali tipo. Il riferimento principale e personale tipo la stessa voce di indirizzo. È consentito un solo ingresso per ogni tipo.
organizzazioni: solo uno è consentito e non supporta gli attributi pref, tipoe dipartimento .
Nota: non supportato, restituendo
null
.IMS: non supportato, restituendo
null
.compleanni: non supportato, restituendo
null
.categorie: non supportato, restituendo
null
.