ContactAddress

Contains address properties for a [Contact](../Contact/contact.html) object.

Properties

  • pref: Set to true if this ContactAddress contains the user's preferred value. (boolean)
  • type: A string that tells you what type of field this is (example: 'home'). _(DOMString)
  • formatted: The full address formatted for display. (DOMString)
  • streetAddress: The full street address. (DOMString)
  • locality: The city or locality. (DOMString)
  • region: The state or region. (DOMString)
  • postalCode: The zip code or postal code. (DOMString)
  • country: The country name. (DOMString)

Details

The ContactAddress object stores the properties of a single address of a contact. A [Contact](../Contact/contact.html) object can have one or more addresses in a ContactAddress[] array.

Supported Platforms

  • Android
  • BlackBerry WebWorks (OS 5.0 and higher)
  • iOS

Quick Example

// 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 contacts
var options = new ContactFindOptions();
options.filter=""; 
var filter = ["displayName","addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);

Full Example

<!DOCTYPE html>
<html>
  <head>
    <title>Contact Example</title>

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

    // Wait for PhoneGap to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap is ready
    //
    function onDeviceReady() {
	    // find all contacts
	    var options = new [ContactFindOptions](../ContactFindOptions/contactfindoptions.html)();
		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" + 
						"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!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Android 2.X Quirks

  • pref: This property is not supported by Android 2.X devices and will always return false.

Android 1.X Quirks

  • pref: This property is not supported by Android 1.X devices and will always return false.
  • type: This property is not supported by Android 1.X devices and will always return null.
  • streetAddress: This property is not support by Android 1.X devices, and will always return null.
  • locality: This property is not support by Android 1.X devices, and will always return null.
  • region: This property is not support by Android 1.X devices, and will always return null.
  • postalCode: This property is not support by Android 1.X devices, and will always return null.
  • country: This property is not support by Android 1.X devices, and will always return null.

BlackBerry WebWorks (OS 5.0 and higher) Quirks

  • pref: This property is not supported on BlackBerry devices and will always return false.
  • type: Partially supported. Only one each of "Work" and "Home" type addresses can be stored per contact.
  • formatted: Partially supported. Will return concatenation of all BlackBerry address fields.
  • streetAddress: Supported. Will return concatenation of BlackBerry address1 and address2 address fields.
  • locality: Supported. Stored in BlackBerry city address field.
  • region: Supported. Stored in BlackBerry stateProvince address field.
  • postalCode: Supported. Stored in BlackBerry zipPostal address field.
  • country: Supported.

iOS Quirks

  • pref: This property is not supported on iOS devices and will always return false.
  • formatted: Not currently supported.