What is UITableView4Android ?

UITableView4Android is an Android library providing a customized ListView with the look & field and behavior of UITableView on iOS.

Note: This is not a recommended Android UI pattern! This repo is only here in case your client insist to do this.

Motivation

Some companies are asking for mobile applications that must have the same appearance both on Android and iOS. And of course, iOS is almost always the version to fit... List views are one the most difficult component to adapt on Android because of corners and borders to set correctly.

Usage example

1. Declare layout

Add the UITableView in your layout :

<fr.days.android.uitableview.view.UITableView
    android:id="@+id/listView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_alignParentLeft="true"
    android:layout_alignParentTop="true" >
</fr.days.android.uitableview.view.UITableView>

2. Implement the adapter

This UITableView is a sub-class of Android ListView and need an implementation of UITableViewAdapter.

class SimpleUITableViewAdapter extends UITableViewAdapter {

    private int[] color_line1_default;
    private int[] color_line2_default;
    private int[] color_line1_pressed;
    private int[] color_line2_pressed;

    public SimpleUITableViewAdapter() {
        // Prepare two sets of colors for odd and even lines
        color_line1_default = new int[] { getResources().getColor(R.color.base_start_color_line1_default), getResources().getColor(R.color.base_end_color_line1_default) };
        color_line2_default = new int[] { getResources().getColor(R.color.base_start_color_line2_default), getResources().getColor(R.color.base_end_color_line2_default) };
        color_line1_pressed = new int[] { getResources().getColor(R.color.base_start_color_line1_pressed), getResources().getColor(R.color.base_end_color_line1_pressed) };
        color_line2_pressed = new int[] { getResources().getColor(R.color.base_start_color_line2_pressed), getResources().getColor(R.color.base_end_color_line2_pressed) };
    }

    @Override
    public int numberOfGroups() {
        return 4;
    }

    @Override
    public int numberOfRows(int group) {
        return (group + 1) * 2;
    }

    @Override
    public UITableHeaderItem headerItemForGroup(Context context, IndexPath indexPath) {
        return new UITableHeaderItem("Group " + indexPath.getGroup());
    }

    @Override
    public UITableCellItem cellItemForRow(Context context, IndexPath indexPath) {
        String title = "Cell number " + indexPath.getRow() + " in group " + indexPath.getGroup();
        String subtitle = (indexPath.getRow() % 2 == 0) ? "Subtitle " + indexPath.getRow() : null;
        return new UITableCellItem(title, subtitle);
    }

    @Override
    public UITableHeaderView headerViewForGroup(Context context, IndexPath indexPath, UITableHeaderItem headerItem, UITableHeaderView convertView) {
        UITableHeaderView headerView;
        if (convertView == null) {
            // If the recycled view is null, we just creating one
            headerView = new UITableHeaderView(context, indexPath);
        } else {
            headerView = (UITableHeaderView) convertView;
        }

        headerView.setTitle(headerItem.title);

        return headerView;
    }

    @Override
    public UITableCellView cellViewForRow(Context context, IndexPath indexPath, UITableCellItem cellItem, UITableCellView convertView) {
        UITableCellView cellView;
        if (convertView == null) {
            // If the recycled view is null, we just creating one with cell's commons parameters
            cellView = new UITableCellView(context, indexPath);
            cellView.setMinimumHeight(80);
            cellView.setAccessory(AccessoryType.DISCLOSURE);
        } else {
            cellView = (UITableCellView) convertView;
        }

        cellView.setTitle(cellItem.title);
        cellView.setSubtitle(cellItem.subtitle);

        // Set alternated background color
        if (indexPath.getRow() % 2 == 0) {
            cellView.setBackgroundColor(color_line1_default, color_line1_pressed);
        } else {
            cellView.setBackgroundColor(color_line2_default, color_line2_pressed);
        }

        return cellView;
    }
}

3. Add listeners

Some listeners are avaible to handle click and long click on cells, headers and accessory's cells. Let's implement them all on our SimpleUITableViewAdapter.

@Override
public void onCellClick(IndexPath indexPath) {
    Toast.makeText(getApplicationContext(), "Cell clicked : " + indexPath, 1000).show();
}

@Override
public boolean onCellLongClick(IndexPath indexPath) {
    Toast.makeText(getApplication(), "Cell long clicked : " + indexPath, 1000).show();
    return indexPath.getRow() % 2 == 0; // Consume the long click one row out of two
}

@Override
public void onCellAccessoryClick(IndexPath indexPath) {
    Toast.makeText(getApplication(), "Cell accessory clicked : " + indexPath, 1000).show();
}

@Override
public void onHeaderClick(IndexPath indexPath) {
    Toast.makeText(getApplicationContext(), "Header clicked : " + indexPath, 1000).show();
}

@Override
public boolean onHeaderLongClick(IndexPath indexPath) {
    Toast.makeText(getApplicationContext(), "Header long clicked : " + indexPath, 1000).show();
    return indexPath.getGroup() % 2 == 0;   // Consume the long click one row out of two
}

4. Configure UITableView

Now, we have an implementation of UITableViewAdapter with all listeners added. It only remains to configure the UITableView.

SimpleUITableViewAdapter tableViewAdapter = new SimpleUITableViewAdapter();
tableView = (UITableView) findViewById(R.id.listView);
tableView.setAdapter(tableViewAdapter);
tableView.setOnCellClickListener(tableViewAdapter);
tableView.setOnCellLongClickListener(tableViewAdapter);
tableView.setOnCellAccessoryClickListener(tableViewAdapter);
tableView.setOnHeaderClickListener(tableViewAdapter);
tableView.setOnHeaderLongClickListener(tableViewAdapter);

Result

And here is the result.