WaveLoadingView

WaveLoadingView - An Android library that provides a realistic wave-loading effect.

Sample

Usage

For a working implementation of this project see the sample/ folder.

Step 1

Include the library as a local library project or add the dependency in your build.gradle.

dependencies {
    compile 'me.itangqi.waveloadingview:library:0.1.4'
    // I have uploaded v0.1.4 on 2015-12-17, if it doesn't take effect or your 
    // gradle cannot find it in maven central, you may try v0.1.2. 
}

Import the library, then add it to your /settings.gradle and /app/build.gradle. If you don't know how to do this, you can read my blog for help.

Step 2

Include the WaveLoadingView widget in your layout. And you can customize it like this.

<me.itangqi.waveloadingview.WaveLoadingView
    android:id="@+id/waveLoadingView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:mlv_borderColor="@color/colorAccent"
    app:mlv_borderWidth="3dp"
    app:mlv_progressValue="40"
    app:mlv_shapeType="square"
    app:mlv_titleBottom="Bottom Title"
    app:mlv_titleBottomColor="@color/colorPrimaryText"
    app:mlv_titleBottomSize="20sp"
    app:mlv_titleCenter="Center Title"
    app:mlv_titleCenterColor="@color/colorPrimaryText"
    app:mlv_titleCenterSize="24sp"
    app:mlv_titleTop="Top Title"
    app:mlv_titleTopColor="@color/colorPrimaryText"
    app:mlv_titleTopSize="20sp"
    app:mlv_waveAmplitude="60"
    app:mlv_waveColor="@color/colorAccent"/>

Step 3

You can write some animation codes to the callbacks such as setOnCheckedChangeListener, onProgressChanged, etc in your Activity.

WaveLoadingView mWaveLoadingView = (WaveLoadingView) findViewById(R.id.waveLoadingView);
	mWaveLoadingView.setShapeType(WaveLoadingView.ShapeType.CIRCLE);
	mWaveLoadingView.setTopTitle("Top Title");
	mWaveLoadingView.setCenterTitleColor(Color.GRAY);
	mWaveLoadingView.setBottomTitleSize(18);
	mWaveLoadingView.setProgressValue(80);
	mWaveLoadingView.setBorderWidth(10);
	mWaveLoadingView.setAmplitudeRatio(60);
	mWaveLoadingView.setWaveColor(Color.GRAY);
	mWaveLoadingView.setBorderColor(Color.GRAY);

Customization

Do what you what :)

name	format	description
mlv_borderWidth	dimension	set border width, default is 0
mlv_borderColor	color	set border color
mlv_progressValue	integer	set progress value, default is 50
mlv_shapeType	enum	set shape type, default is circle
mlv_waveColor	color	set wave color
mlv_waveAmplitude	float	set wave amplitude
mlv_titleTopSize	dimension	set top title size, default is 18
mlv_titleCenterSize	dimension	set center title size, default is 22
mlv_titleBottomSize	dimension	set bottom size, default is 18
mlv_titleTopColor	color	set top title color
mlv_titleCenterColor	color	set center title color
mlv_titleBottomColor	color	set bottom title color
mlv_titleTop	string	set top title content, default is null
mlv_titleCenter	string	set center title content, default is null
mlv_titleBottom	string	set bottom title content, default is null

All attributes have their respective getters and setters to change them at runtime.

ChangeLog

0.1.4

Fix the bug which setProgressValue() doesn't change the value of mProgressValue
Fix attributes' setters

0.1.3

Fix the bug which Attribute "borderWidth" has already been defined
Prefix the attributes with "wlv"

Demo

Download

Community

Looking for contributors, feel free to fork !

Tell me if you're using my library in your application, I'll share it in this README.

Thanks

Inspired by

WaveView created by gelitenight
CircularFillableLoaders created by lopspower

Contact Me

Born in 1992, now a student of Southeast University, master of Software Engineering. Loving technology, programming, reading and sports.

I will graduate in June 2017, expect the internship or full-time job in Android or iOS.

If you have any questions or want to make friends with me, please feel free to contact me : imtangqi#gmail.com

License

Copyright 2015 Qi Tang

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.

wing7 / WaveLoadingView