English | 中文
LoadingStateView
is a highly expandable Android library for showing loading status view on the low-coupling way, it is implemented with a Kotlin code of less than 300 lines without comment statement . it not only shows different view like loading, content, error, empty and customized view when loading network data, but also manages title bar.
- No need to add view code to the layout.
- Support for show custom views.
- Support for use for Activity, Fragment, RecyclerView, View.
- Support for managing the title bar and add multiple headers.
- Support for set reload event.
- Support for update views anytime.
- Support for use with most third-party libraries.
Click or scan QR code to download
Activity(error) | View(placeholder) | ViewPager(timeout) | RecyclerView(cool loading) |
---|---|---|---|
SpecialHeader(custom) | MultipleHeader(search) | SpecialDecorView(scrolling) | BottomDecorView(editor) |
---|---|---|---|
Add it in your root build.gradle
at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}
Add dependencies in your module build.gradle
:
dependencies {
implementation 'com.github.DylanCaiCoding:LoadingStateView:3.0.0'
}
public class LoadingViewDelegate extends LoadingStateView.ViewDelegate<LoadingStateView.ViewHolder> {
@NonNull
@Override
public LoadingStateView.ViewHolder onCreateViewHolder(@NonNull LayoutInflater inflater, @NonNull ViewGroup parent) {
return new LoadingStateView.ViewHolder(inflater.inflate(R.layout.layout_loading_view, parent, false));
}
@Override
public void onBindViewHolder(@NonNull LoadingStateView.ViewHolder holder) {
}
}
LoadingStateView loadingStateView = new LoadingStateView(this);
loadingStateView.register(ViewType.LOADING, new LoadingViewDelegate());
loadingStateView.setViewDelegatePool(pool -> {
pool.register(ViewType.LOADING, new LoadingViewDelegate());
return null;
});
loadingStateView.showView(viewType);
loadingStateView.showLoadingView(); // view type is ViewType.LOADING
loadingStateView.showContentView(); // view type is ViewType.CONTENT
loadingStateView.showErrorView(); // view type is ViewType.ERROR
loadingStateView.showEmptyView(); // view type is ViewType.EMPTY
loadingStateView.setOnReloadListener(new LoadingStateView.OnReloadListener() {
@Override
public void onReload() {
// request data again
}
});
//In the adapter
holder.getOnReloadListener.onReload();
ErrorViewDelegate errorViewDelegate = loadingStateView.getViewDelegate(ViewType.ERROR);
errorViewDelegate.errorText = "Fail to load, please wait";
loadingStateView.notifyDataSetChanged(ViewType.ERROR);
If you want to add an ordinary title bar above the content.
Similar to the previous usage, create a class extends LoadingStateView.ViewDelegate<VH extends ViewHolder>
and set header.
loadingStateView.setDecorHeader(new TitleViewDelegate("title"), new SearchHeaderViewDelegate());
If you want to add an special title bar with linkage effect.
Create a class extends LoadingStateView.DecorViewDelegate
to create a decorated view and specify a loading container.
class ScrollingDecorViewDelegate : LoadingStateView.DecorViewDelegate() {
@NotNull
override fun onCreateDecorView(@NotNull inflater: LayoutInflater): View {
return inflater.inflate(R.layout.layout_scrolling, null)
}
@NotNull
fun getContentParent(@NotNull decorView: View): ViewGroup {
return decorView.findViewById(R.id.content_parent)
}
}
Then set it up.
loadingStateView.setDecorView(new ScrollingDecorViewDelegate());
The original name of this library is LoadingHelper
, and some class and method names should be changed later. Old users can check the migration guide and change it to the latest usage. If you feel troublesome and are not obsessive-compulsive, you can also not migrate.
- ViewBindingKTX, the most comprehensive utils of ViewBinding.
- ActivityResultLauncher, replace
startActivityForResult()
method gracefully.
- luckbilly/Gloading Optimize my library standing on the shoulders of giants.
- drakeet/MultiType Referenced the usage of multiple adapters.
- dinuscxj/LoadingDrawable The cool loading effect in the demo.
Copyright (C) 2019. Dylan Cai
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.