alamkanak / android-empty-layout Goto Github PK

View Code? Open in Web Editor NEW

601.0 30.0 164.0 981 KB

A library for showing different types of layouts when a list view is empty

License: Apache License 2.0

Java 100.00%

android-empty-layout's Introduction

Android Empty Layout

Please note that this project is not being maintained now. Hopefully a new version will be available soon.

A library for showing different types of layouts when a list view is empty. These layouts can be shown when,

the list is loading
the list has no item to display
an error occured trying to load items

Loading animation is also supported.

Screenshots

Usage

Import the library project into your workspace.
Use the imported project as a library for your project.
In the onCreate event of your activity use the following code.

mListAdapter.clear();
EmptyLayout emptyLayout = new EmptyLayout(this, getListView());

When you want to show the loading animation, use this code.

mListAdapter.clear();
emptyLayout.showLoading();

When you want to show any error, use this code.

mListAdapter.clear();
emptyLayout.showError();

When your list doesn't have any item to show, use this code.

mListAdapter.clear();
emptyLayout.showEmpty();

Thats all you have to do to use this library. You may want to customize its behavior though.

P.S. Make sure you always clear the list adapter before calling showEmpty, showLoading and showError. The list have to empty after all.

Customization

There are bunch of methods to let you customize this pattern. Use the methods like this.

emptyLayout.setLoadingMessage("Please wait...");

Some useful methods are given below

showEmpty
showLoading
showError
setLoadingView
setEmptyView
setErrorView
setLoadingAnimation
setErrorMessage
setLoadingMessage
setEmptyMessage
setEmptyViewButtonClickListener
setLoadingViewButtonClickListener
setErrorViewButtonClickListener
setShowEmptyButton
setShowLoadingButton
setShowErrorButton

and there is more...

Example

A simple example is also available.

License

Copyright 2014 Raquib-ul-Alam

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.

android-empty-layout's People

Contributors

Stargazers

Watchers

Forkers

fenderstr iamswapnilsonar ingyesid nantaphop pareshmayani yy520libozhi morristech lailiaomm brandhill ufo22940268 httpsnail tomkeyzhang marianmoldovan yesidlazaro renangrativol wang663632304 makeclan saranjith mistrydarshan99 wenjianxue qiailin g1258624735 xiedantibu missyang srinivas69 xiaodatao wuruize jitendra7020 jtyang pochadri manithnuon qinglinyi wang9090980 khalidelsayed rameshakulapc 0359xiaodong luosong yanlusu feer921 modmed guenodz mrx-andy popboyking brucewaynee jbaginski fork-lib xiaomeixw xuhuawei131 yzp531 yanceylee splm ertos12 jayin hy2012 lapngodoan haikuowuya aaaliua robertschou wolf0931 tyl210110 jollyjiang b1ink301 bayan1987 rizkifawzila faris-mobile89 githubzoujiayun cgpllx hardikbhalodi chenjinguang jashion ruijun sobhit0018 wuqingman huzhennan datalink747 hbally trioblack yanglichuan djun100 sangupandi vercent ilber 583472074 liuwei3230 lizanle521 shercoder hardikamal iknow4 walfud williamren xianchang2409 huamaomao toumingyu haogg alaricnorris lstnull svenjung zzvvc sayi21cn rvganesh

android-empty-layout's Issues

Advice: the 'Empty View' should stay in center of list instead of its parent container.

hello, I found a problem while learning your code. see the usage below:

then, you add "Empty View" into the parent of mListView (see EmptyLayout.java:463)
You view looks like this:

Obviously, I want the picture in center of list view instead of its parent.

Now I make a little change at EmptyLayout.java:changeEmptyType(), you can easily understand.

~~~
    // insert views in the root view
    if (!mViewsAdded) {
        RelativeLayout.LayoutParams lp = new LayoutParams(mListView.getWidth(), mListView.getHeight());
        lp.topMargin = mListView.getTop();
        lp.leftMargin = mListView.getLeft();
        RelativeLayout rl = new RelativeLayout(mContext);
        rl.setLayoutParams(lp);
        if (mEmptyView!=null) {
            rl.addView(mEmptyView);
            RelativeLayout.LayoutParams layoutParams = (RelativeLayout.LayoutParams) mEmptyView.getLayoutParams();
            layoutParams.addRule(RelativeLayout.CENTER_IN_PARENT);
            mEmptyView.setLayoutParams(layoutParams);
        }
        if (mLoadingView!=null) {
            rl.addView(mLoadingView);
            RelativeLayout.LayoutParams layoutParams = (RelativeLayout.LayoutParams) mLoadingView.getLayoutParams();
            layoutParams.addRule(RelativeLayout.CENTER_IN_PARENT);
            mLoadingView.setLayoutParams(layoutParams);
        }
        if (mErrorView!=null) {
            rl.addView(mErrorView);
            RelativeLayout.LayoutParams layoutParams = (RelativeLayout.LayoutParams) mErrorView.getLayoutParams();
            layoutParams.addRule(RelativeLayout.CENTER_IN_PARENT);
            mErrorView.setLayoutParams(layoutParams);
        }
        mViewsAdded = true;

        ViewGroup parent = (ViewGroup) mListView.getParent();
        parent.addView(rl);
        mListView.setEmptyView(rl);
    }
~~~

Thanks for your good code.

Crash the SwipeRefreshLayout

SwipeRefreshLayout (from support v4 19.1) can has only 1 child.
Currently my solution is to check if the parent is that, and then get its parent (should also check if he has parent, but in my code it always has a parent):

ViewGroup parent = (ViewGroup) mListView.getParent();
            // Start editing
            if (parent instanceof SwipeRefreshLayout) {
                parent = (ViewGroup) parent.getParent();
            }
            // End editing

mEmptyLayout.setEmptyMessage(emptyMessage);
mEmptyLayout.setShowEmptyButton(showEmptyButton);
mEmptyLayout.setEmptyButtonClickListener(listener);
mEmptyLayout.showEmpty();

That is my code, when showEmptyButton is true.
The problem is that the empty button isn't shown

Not in center at ListFragment

Can u make it compatible to use with RecycleView??

Hi Alam,

First of all thanks for the awesome library.Can u please make it compatible with the recycleview if possible.It would be great to use it with recycleview.