Skip to content

MeetMe/Android-MultiStateView

BranchesTags

Repository files navigation

MultiStateView

Handles multiple display states for data-centric views

  • Content state; shows the inner content of the View (as defined in XML)
  • Loading state; shows a Loading state (as specified either via the loadingLayout attribute, or the default layout (res/layout/msv__loading.xml)

The following shows examples (using default layouts) for Loading, General Error, Network Error, and the Content states (where we've made the "Hello World" the content) in respective order.

Loading state  General error state

Network error state  Content state

Usage

  • For whatever View you want to switch out with MultiStateView, wrap the View in a MultiStateView node.
  • In code, get your reference to the child of MultiStateView via MultiStateView#getContentView() and cast that value as needed. There's no good reason to put an android:id on the child View.

Example

  • Assuming you're starting with:
        <LinearLayout
            xmlns:android="http://schemas.android.com/apk/res/android"
            android:layout_width="fill_parent"
            android:layout_height="fill_parent"
            android:orientation="vertical" >

            <ListView
                android:id="@+id/list"
                android:layout_width="fill_parent"
                android:layout_height="match_parent" />

        </LinearLayout>
  • You should end up with something like:
        <LinearLayout
            xmlns:android="http://schemas.android.com/apk/res/android"
            android:layout_width="fill_parent"
            android:layout_height="fill_parent"
            android:orientation="vertical" >

            <com.meetme.android.multistateview.MultiStateView
                android:id="@+id/list_container"
                android:layout_width="match_parent"
                android:layout_height="match_parent">

                <ListView
                    android:layout_width="fill_parent"
                    android:layout_height="match_parent" />

            </com.meetme.android.multistateview.MultiStateView>

        </LinearLayout>

Example Notes 0. android:id="@+id/list" was moved from the ListView to the MultiStateView 0. It was also renamed to list_container to note that it now is the parent of the ListView 0. Any references in code should now use MultiStateView#getContentView() casted to ListView to reference the ListView child. There's no good reason to put an id on the ListView. See below.

  • In code,
ListView list = (ListView) findViewById(R.id.list);
  • Becomes
MultiStateView container = (MultiStateView) findViewById(R.id.list_container);
ListView list = (ListView) container.getContentView();
  • To control the state of the MultiStateView, use the MultiStateView#setState(State) method.
container.setState(State.LOADING);
  • By default, "Loading" indication uses the loading layout provided in the library (res/layout/msv__loading.xml). To customize, you can add the custom attribute msvLoadingLayout to the MultiStateView in XML with a reference to the layout to inflate.

Contributors

License