ContactName

Contiene atributos sobre nombres de un objeto Contact.

Atributos

  • formatted: El nombre completo del contacto formateado. (DOMString)
  • familyName: Apellidos de familia. (DOMString)
  • givenName: El primer nombre del contacto. (DOMString)
  • middleName: El Segundo nombre del contacto, por ejemplo: de “Juan José” es “José”. (DOMString)
  • honorificPrefix: Prefijo del nombre, comúnmente por anglosajones (ejemplo: Mr, Dr...) (DOMString)
  • honorificSuffix: Sufijo del nombre, comúnmente usado por anglosajones (ejemplo: Jr...). (DOMString)

Detalles

El objeto ContactName guarda atributos sobre el nombre de un contacto.

Plataformas Soportadas

  • Android 2.X
  • BlackBerry WebWorks (OS 5.0 y superior)
  • iOS

Ejemplo Rápido

function onSuccess(contacts) {
	for (var i=0; i<contacts.length; i++) {
		alert("Nombre formateado: " + contacts[i].name.formatted + "\n" + 
				"Apellidos: "  + contacts[i].name.familyName + "\n" + 
				"Primer Nombre: "  + contacts[i].name.givenName + "\n" + 
				"Segundo Name: "  + contacts[i].name.middleName + "\n" + 
				"Sufijo del nombre: "  + contacts[i].name.honorificSuffix + "\n" + 
				"Prefijo del nombre: "  + 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);

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Contacts</title>

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

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
	var options = new ContactFindOptions();
	options.filter="";
	filter = ["displayName","name"];
	navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Obtiene el resultado
    //
function onSuccess(contacts) {
        for (var i=0; i<contacts.length; i++) {
		alert("Nombre formateado: " + contacts[i].name.formatted + "\n" + 
			"Apellidos: "  + contacts[i].name.familyName + "\n" + 
			"Primer Nombre: "  + contacts[i].name.givenName + "\n" + 
			"Segundo nombre: "  + contacts[i].name.middleName + "\n" + 
			"Sufijo del nombre: "  + contacts[i].name.honorificSuffix + "\n" + 
			"Prefijo del nombre: "  + contacts[i].name.honorificPrefix);
		}
	};

    // onError: Ocurrió un error
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Ejemplo</h1>
    <p>Búsqueda de Contactos</p>
  </body>
</html>

Peculiaridades Android

  • formatted: Soportada parcialmente. Retornara la concatenación de honorificPrefix, givenName, middleName, familyName and honorificSuffix pero no sera almacenado.

Peculiaridades BlackBerry WebWorks (OS 5.0 y superior)

  • formatted: Soportada parcialmente. Retornara la concatenación de los campos de BlackBerry__firstName__ y lastName.
  • familyName: Soportada. Almacenado en el campo de BlackBerry lastName.
  • givenName: Soportada. Almacenada en el campo de BlackBerry firstName.
  • middleName: Esta propiedad no esta soportada, y siempre retornara null.
  • honorificPrefix: Esta propiedad no esta soportada, y siempre retornara null.
  • honorificSuffix: Esta propiedad no esta soportada, y siempre retornara null.

Peculiaridades iOS

  • formatted: Soportada parcialmente. Retornara el nombre compuesto en iOS pero no lo almacenara.