Titanium.Contacts.showContactsParams
Dictionary of options for the Titanium.Contacts.showContacts method.
Since: 0.8, 0.8, 0.8, 9.2.0 · Platforms: android, iphone, ipad, macos
Properties #
animated#
Type: Boolean
Determines whether to animate the show/hide of the contacts picker (iPhone, iPad only.)
fields#
Type: Array<String>
Field names to show when selecting properties. By default, shows all available.
selectedPerson#
Type: Callback<Object>
Function to call when a person is selected. Must not be used with selectedProperty property.
selectedProperty#
Type: Callback<Object>
Function to call when a property is selected. Must not be used with selectedPerson
property.
Note: If ringtone or texttone is selected, null values are returned, since these are unsupported
by Apple.
Since iOS 9.0, there is a native apple issue whereby it may return null if the birthday property
is selected on certain device models.
The callback contains the selected property and a 'person' object of type Titanium.Contacts.Person.
Since iOS 9.0, apple only returns the person object with partial information. Currently it is known to
at least contain the selected property and fullName.