DobList

DobList (Google Play Demo)

Any Android developer needs Endless ListView, and needs progress dialog to be shown in the middle of his own ListView at first loading data, so he will write the code line by line or use a custom ListView to get some features and lost his own ListView.

What about getting desired features with your own ListView and its derivatives!

DobList is an Open Source Android library that provides to ListView adding ProgressBar (or any view) to the footer of ListView to be shown in loading more, and callback that is called when reaching last item in ListView.

Here is a short video for the example application in this repository : http://youtu.be/1TPzJDpUwug

Setup

In Eclipse, just import the library as an Android library project. Project > Clean to generate the binaries you need, like R.java, etc. Then, just add DobList as a dependency to your existing project.

How?

	public View onCreateView(LayoutInflater inflater, ViewGroup container,
			Bundle savedInstanceState) {
		View rootView = inflater.inflate(R.layout.fragment_main, container,
				false);

		// ListView initializing
		ListView mListView = (ListView) rootView.findViewById(R.id.mListView);

		// Set DobList before setting adapter
		initDobList(rootView, mListView);

		// Set adapter
		mListView.setAdapter(adapter);

		return rootView;
	}

	private void initDobList(View rootView, ListView listView) {

		// DobList initializing
		dobList = new DobList();
		try {

			// Register ListView
			//
			// NoListViewException will be thrown when
			// there is no ListView
			dobList.register(listView);

			// Add ProgressBar to footers of ListView
			// to be shown in loading more
			dobList.addDefaultLoadingFooterView();

			// Sets the view to show if the adapter is empty
			// see startCentralLoading() method
			View noItems = rootView.findViewById(R.id.noItems);
			dobList.setEmptyView(noItems);

			// Callback called when reaching last item in ListView
			dobList.setOnLoadMoreListener(new OnLoadMoreListener() {

				@Override
				public void onLoadMore(final int totalItemCount) {
					Log.i(TAG, "onStart totalItemCount " + totalItemCount);

					// Just inserting some dummy data after
					// period of time to simulate waiting
					// data from server
					addDummyData(10);
				}
			});

		} catch (NoListViewException e) {
			e.printStackTrace();
		}

		try {
			// Show ProgressBar at the center of ListView
			// this can be used while loading data from
			// server at the first time
			//
			// setEmptyView() must be called before
			//
			// NoEmptyViewException will be thrown when
			// there is no EmptyView
			dobList.startCentralLoading();

		} catch (NoEmptyViewException e) {
			e.printStackTrace();
		}
		// Simulate adding data at the first time
		addDummyData(5);
	}

	protected void addDummyData(final int itemsCount) {
		new Handler().postDelayed(new Runnable() {

			@Override
			public void run() {
				addItems(adapter.getCount(), adapter.getCount() + itemsCount);

				// We must call finishLoading
				// when finishing adding data
				dobList.finishLoading();
			}

		}, 2000);
	}

Properties

• Set / get ListView - for ListView and its derivatives such as ExpandableListView
• Set / get footerLoadingView - to define and access a custom footer that will be shown in loading more
• Set / get emptyView - Sets and get the view to show if the adapter is empty. See startCentralLoading() method
• Set / get maxItemsCount - Here you can specify the maximum number of items in ListView.
• Set / get onLoadMoreListener - Callback that is called when reaching last item in ListView.
• Set / get onScrollListener - Because DobList consumes OnScrollListener, here you can use OnScrollListener.

Methods

• register - Register ListView. NoListViewException will be thrown when there is no ListView.
• addDefaultLoadingFooterView - Add ProgressBar to footers of ListView to be shown in loading more.
• startCentralLoading - Show ProgressBar at the center of ListView this can be used while loading data from server at the first time.

setEmptyView() must be called before.

NoEmptyViewException will be thrown when there is no EmptyView.

Events

• OnLoadMoreListener - Callback that is called when reaching last item in ListView.

Developed By

Bilal Sammour - [email protected]

License

Copyright 2014 Bilal Sammour

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.