android-uitableview

Library and example project on how to use the UITableView component

Code Quality Rank: L5

Programming language: Java

Tags: Other Widget    

README

UITableView for Android

Usage

Installation

Android Studio

1. Paste or clone this library into the /libs folder, in the root directory of your project. Create a new folder: /libs if not already present. (This step is not required - only for keeping cleaner project structure)

2. Edit settings.gradle by adding the library. You have also define a project directory for the library. Your settings.gradle should look like below:

   include ':app', ':UITableView'
   project(':UITableView').projectDir = new File('libs/UITableView')
   

3. In app/build.gradle add the UITableView library as a dependency:

   dependencies {
       compile fileTree(dir: 'libs', include: ['*.jar'])
       compile 'com.android.support:appcompat-v7:21.0.3'
       compile project(":UITableView")
   }
   

4. Sync project, clean and build. You can use the UITableView as part of your project now.

Eclipse

Before you can add a UITableView to your application, you must first add a library reference:

1. Clone or download a copy of the library
2. Import the library into Eclipse: File menu -> Import -> Existing Project into Workspace
3. Open your application's project properties and add a library reference to "UITableView"

Using UITableView in your project

Defining your layout

<br.com.dina.ui.widget.UITableView 
    android:id="@+id/tableView" 
    style="@style/UITableView" />

Working on your activity

public class Example1Activity extends Activity {    
    UITableView tableView;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);        
        tableView = (UITableView) findViewById(R.id.tableView);        
        createList();        
        Log.d("Example1Activity", "total items: " + tableView.getCount());        
        tableView.commit();
    }

    private void createList() {
        CustomClickListener listener = new CustomClickListener();
        tableView.setClickListener(listener);
        tableView.addBasicItem("Example 1", "Summary text 1");
        tableView.addBasicItem("Example 2", "Summary text 2");
        tableView.addBasicItem("Example 3", "Summary text 3");
        tableView.addBasicItem("Example 4", "Summary text 4");
    }

    private class CustomClickListener implements ClickListener {
        @Override
        public void onClick(int index) {
            Toast.makeText(Example1Activity.this, "item clicked: " + index, Toast.LENGTH_SHORT).show();
        }       
    }    
}

UITableViewActivity

In order to use the default list you can extend the UITableViewActivity, a simple example can be found in the source code below:

public class ExampleActivity extends UITableViewActivity {  

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        CustomClickListener listener = new CustomClickListener();
        getUITableView().setClickListener(listener);
    }

    private class CustomClickListener implements ClickListener {    
        @Override
        public void onClick(int index) {
            Toast.makeText(ExampleActivity.this, "item clicked: " + index, Toast.LENGTH_SHORT).show();
        }           
    }

    @Override
    protected void populateList() {
        getUITableView().addItem("Example 1", "Summary text 1");
        getUITableView().addItem("Example 2", "Summary text 2");
        getUITableView().addItem("Example 3", "Summary text 3");
        getUITableView().addItem("Example 4", "Summary text 4");
        getUITableView().addItem("Example 5", "Summary text 5");        
    }       
}

In this example you don't even need to care about the xml since the UITableViewActivity is using a default layout template the only displays the list in the screen. It is pretty mych the same list you are seeing in the screenshot provided at the beginning of this explanation.

UIButton

<LinearLayout
    android:orientation="vertical"
    android:layout_width="fill_parent"  
    android:layout_height="fill_parent">    

        <br.com.dina.ui.widget.UIButton
            android:layout_width="fill_parent"  
            android:layout_height="fill_parent"
            android:padding="10dip"
            ui:title="some title one"/>

        <br.com.dina.ui.widget.UIButton
            android:layout_width="fill_parent"  
            android:layout_height="fill_parent"
            ui:title="some title two"
            ui:subtitle="some subtitle two"
            android:padding="10dip" />  

        <br.com.dina.ui.widget.UIButton
            android:layout_width="fill_parent"  
            android:layout_height="fill_parent"
            ui:title="some title three"
            ui:subtitle="with image"
            ui:image="@drawable/search_image"
            android:padding="10dip"/>                           
</LinearLayout>

Customization

UITableView is an Android Library Project and all its resources will be merged into the referring project. So, in order tu customize the colors of the UITableView and its elements, you need to create the same resources on your own project and this resources will be before the default values provided by the library project.

If you don't like the default colors that is defined in the colors.xml file simply override the default values in the main projects colors.xml file. These are the keys you need to work on to have your customized UITableView working.

<?xml version="1.0" encoding="utf-8"?>
<resources> 
    <!-- LIST BORDER COLOR -->
    <color name="rounded_container_border">#ffb7babb</color>

    <!-- ITEM BACKGROUND COLOR - STATE - DEFAULT -->
    <color name="base_start_color_default">#FFFFFF</color>
    <color name="base_end_color_default">#FFFFFF</color>

    <!-- ITEM BACKGROUND COLOR - STATE - PRESSED -->
    <color name="base_start_color_pressed">#ff3590c4</color>
    <color name="base_end_color_pressed">#ff2570ba</color>

    <!-- ITEM TEXT COLORS - STATES - PRESSED AND DEFAULT -->
    <color name="text_color_default">#000000</color>
    <color name="text_color_pressed">#ffffff</color>            
</resources> 

Example

The theme above was created using the following set of colors:

<resources>
    <color name="rounded_container_border">#50b7babb</color>
    <color name="base_start_color_default">#B0FFFFFF</color>
    <color name="base_end_color_default">#B0FFFFFF</color>
    <color name="base_start_color_pressed">#B03590c4</color>
    <color name="base_end_color_pressed">#B02570ba</color>
    <color name="text_color_default">#000000</color>
    <color name="text_color_pressed">#ffffff</color>   
</resources>

Android applications using it

Contributions

Functionallity improvements and performance enhancements are always welcome. Feel free to fork and apply your changes.

TODO list

• Hability to let the user define the custom layout for the item
• Hability to create Items that expand/collapse a set of items

Other Android Libraries

Use these libraries also to get a better UI for your android application

• Android ActionBar by Johan Nilsson
• Android Pull to Refresh by Johan Nilsson
• SwipeView by Jason Fry
• Facebook Integration by Lorensius
• Twitter Integration by Lorensius
• Quick Actions by Lorensius

License

Copyright (c) 2011 [Thiago Locatelli] - "thiago:locatelli$gmail:com".replace(':','.').replace('$','@')

Licensed under the Apache License, Version 2.0