robertjli / android-contacts-edit-text

An Android AutoComplete widget for contacts using a CursorLoader

ContactsEditText

About

This library is an Android AutoComplete widget for contacts. At the time of this writing, most similar projects seem to pull the entire list of contacts down into a Java list, then use a ListAdapter to back the widget. This version does it the "proper" way, using a CursorLoader and the contacts provider.

Usage

First, add the project in the library folder to your project as a library project.

Add the widget to your XML layout like so:

<net.robertli.android.contactsedittext.ContactsEditText
    android:id="@android:id/input"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:inputType="textPersonName" />

In your Java code, set its onItemClickListener:

ContactsEditText editText = (ContactsEditText) findViewById(android.R.id.input);
editText.setOnItemClickListener(new AdapterView.OnItemClickListener() {
    @Override
    public void onItemClick(AdapterView<?> parent, View view, int position,
            long id) {
        ContactsEditText.Contact contact =
                (ContactsEditText.Contact) parent.getItemAtPosition(position);

        // Do something with the contact entry

        editText.setText("");
    }
});

Note that the ContactsEditText.Contact class is just a holder class. It contains the following fields:

public class Contact {
    public String displayName; // ContactsContract.Contacts.DISPLAY_NAME_PRIMARY
    public Bitmap image;       // ContactsContract.Contacts.PHOTO_THUMBNAIL_URI
    public long   id;          // ContactsContract.Contacts._ID
    public String lookupKey;   // ContactsContract.Contacts.LOOKUP_KEY
}

You'll notice that in the example listener above, I clear the text of the widget. This isn't necessary, and if you don't clear it, it will separate entries by commas.

Contributions

Feel free to fork, request pulls, submit issues, whatever you like!

I kind of just wrote this for my own needs, and I'm definitely not a pro at Android, but I will try to add features if they seem interesting.

License

Copyright (C) 2012 Robert Li

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.