README.md

#L Navigation Drawer

---

Library allowing you to easily replicate the new style of navigation drawer from Android L. This library consists a custom listview that you place in your navigation drawer and will handle the work for you.

---

##Set up (Android Studio)

Download the aar here: https://www.dropbox.com/s/x6rnd4z6ek4fijr/lnavigationdrawer.aar?dl=0

You can rename the aar and then place it in the libs directory of your project.

Go into your build.gradle and add the following:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'uk.me.lewisdeane.lnavigationdrawer:RENAMED_FILE_NAME_HERE@aar'
}

repositories{
    flatDir{
        dirs 'libs'
    }
}

Usage

To use this library, use the tag

<uk.me.lewisdeane.lnavigationdrawer.NavigationListView /* All normal attributes here */ />

In your java file you can now say

NavigationListView navigationListView = (NavigationListView) findViewById(R.id.ID_OF_XML_LIST);

Note: Please make sure the images passed in are fully opaque otherwise the same effect cannot be achieved.

This list is populated with an object called NavigationItem which has 3 properties, title, image and whether it's selected or not. It has 3 constructors as follows and each item is unselected by default:

new NavigationItem(String title); // Just a piece of text
new NavigationItem(String title, int imgRes); // Image and text
new NavigationItem(String title, imgRes, boolean selected); // Image, text and ability to set selected.

To populate your list you can simply call a variety of methods:

.addNavigationItem(String title, int imgRes, boolean selected); // Adds a new item with specified properties from parameters.
.addNavigationItem(NavigationItem navigationItem); // Adds a new item with specified properties.
.setItems(String[] items); // Set the items appearing in the list.
.setImages(int[] imgsRes); // Set the images to appear in the list.

Now we have a populated list we can use other methods such as:

navigationListView.setSelectedColor(String hex); // Set hex colour as selected colour
navigationListView.setSelectedItem(int position); // Sets the current selected item to one specified in parameter.

To handle click events simply call:

navigationListView.setNavigationItemClickListener(new NavigationItemClickListener(){
    @Override
    public void onNavigationItemSelected(String item, ArrayList<NavigationItem> items, int position){
        // Do your stuff when an item is selected, do not worry about changing the colour or anything as it is handled for you.
    }
});

I will try and bring more features to this library but for now it should be fine, you can use this in your app for free, enjoy!