ContactName
Contiene diversi tipi di informazioni circa un Contact
nome dell'oggetto.
Proprietà
formattato: il nome completo del contatto. (DOMString)
familyName: cognome del contatto. (DOMString)
givenName: nome del contatto. (DOMString)
middleName: il nome del contatto medio. (DOMString)
honorificPrefix: prefisso del contatto (esempio Mr o Dr) (DOMString)
honorificSuffix: suffisso del contatto (esempio Esq.). (DOMString)
Dettagli
Il ContactName
oggetto memorizza la proprietà del nome di un contatto.
Piattaforme supportate
- Android 2. x
- BlackBerry WebWorks (OS 5.0 e superiori)
- iOS
- Windows Phone 7 e 8
- Windows 8
Esempio rapido
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 = new ContactFindOptions();
options.filter = "";
filter = ["displayName", "name"];
navigator.contacts.find(filter, onSuccess, onError, options);
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() {
var options = new ContactFindOptions();
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!');
}
</script>
</head>
<body>
<h1>Example</h1>
<p>Find Contacts</p>
</body>
</html>
Stranezze Android
- formattato: parzialmente supportati e di sola lettura. Restituisce una concatenazione di
honorificPrefix
,givenName
,middleName
,familyName
, ehonorificSuffix
.
Stranezze di blackBerry WebWorks (OS 5.0 e superiori)
formattato: parzialmente supportati. Restituisce una concatenazione di campi firstName e lastName BlackBerry.
familyName: supportato. Archiviato in campo lastName BlackBerry.
givenName: supportato. Archiviato in campo firstName BlackBerry.
middleName: non supportato, restituendo
null
.honorificPrefix: non supportato, restituendo
null
.honorificSuffix: non supportato, restituendo
null
.
iOS stranezze
- formattato: parzialmente supportati. Restituisce il nome composito di iOS, ma è di sola lettura.