Skip to content

Latest commit

 

History

History
executable file
·
267 lines (168 loc) · 8.43 KB

README.md

File metadata and controls

executable file
·
267 lines (168 loc) · 8.43 KB

WaveLoadingView

Android Arsenal License

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

Sample

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 {
    implementation 'me.itangqi.waveloadingview:library:0.3.5'
    // I have uploaded v0.3.5 on 2017-01-06, if it doesn't take effect or your
    // gradle cannot find it in maven central, you may try v0.3.4.
}

Or

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:wlv_borderColor="@color/colorAccent"
    app:wlv_borderWidth="3dp"
    app:wlv_progressValue="40"
    app:wlv_shapeType="circle"
    app:wlv_round_rectangle="true"
    app:wlv_triangle_direction="north"
    app:wlv_titleCenterStrokeColor="@android:color/holo_blue_dark"
    app:wlv_titleCenterStrokeWidth="3dp"
    app:wlv_titleCenter="Center Title"
    app:wlv_titleCenterColor="@android:color/white"
    app:wlv_titleCenterSize="24sp"
    app:wlv_waveAmplitude="70"
    app:wlv_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);
    mWaveLoadingView.setTopTitleStrokeColor(Color.BLUE);
    mWaveLoadingView.setTopTitleStrokeWidth(3);
    mWaveLoadingView.setAnimDuration(3000);
    mWaveLoadingView.pauseAnimation();
    mWaveLoadingView.resumeAnimation();
    mWaveLoadingView.cancelAnimation();
    mWaveLoadingView.startAnimation();

Customization

Please feel free to :)

name format description
wlv_borderWidth dimension Border width, default is 0
wlv_borderColor color Border color
wlv_progressValue integer Pprogress value, default is 50
wlv_shapeType enum Shape type, default is circle
wlv_triangle_direction enum Triangle direction, default is north
wlv_round_rectangle boolean Is round rectangle, default is false
wlv_round_rectangle_x_and_y integer Round Rectangle corners, default is 30
wlv_waveColor color Wave color
wlv_wave_background_Color color Wave background color
wlv_waveAmplitude float Wave amplitude
wlv_titleTop string Top title content, default is null
wlv_titleCenter string Center title content, default is null
wlv_titleBottom string Bottom title content, default is null
wlv_titleTopSize dimension Top title size, default is 18
wlv_titleCenterSize dimension Center title size, default is 22
wlv_titleBottomSize dimension Bottom size, default is 18
wlv_titleTopColor color Top title color
wlv_titleCenterColor color Center title color
wlv_titleBottomColor color Bottom title color
wlv_titleTopStrokeColor color Top title stroke color
wlv_titleCenterStrokeColor color Center title stroke color
wlv_titleBottomStrokeColor color Bottom title stroke color
wlv_titleTopStrokeWidth dimension Top title stroke width
wlv_titleCenterStrokeWidth dimension Center title stroke width
wlv_titleBottomStrokeWidth dimension Bottom title stroke width

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

Change Log

0.3.5(2017-01-06)

Update:

  • Support change the frequency of the waves. #13 / #23

0.3.4(2017-01-05)

Update:

  • Support pause/resume wave. #28 / #26

Plan:

  • Support change the frequency of the waves

0.3.3(2016-10-14)

0.3.2(2016-07-29)

Update:

0.3.1(2016-07-23)

Update:

  • Added stroke feature to all titles. Strokes are disabled by default. by shayanzoro

0.3.0 (2016-06-07)

Fixed bugs:

  • How to set match_parent width? #12

0.2.3(2016-05-25)

Update:

  • Support the minSdkVersion to 14

0.2.2(2016-05-23)

Fixed bugs:

  • Default amplitude value #12

0.2.1 (2016-05-21)

Update:

  • Update more shape types like: Rectangle, Round Rectangle, Triangle...etc #7
  • Update build.gradle
  • Update Sample

Plan:

  • Title position fit shape size

0.2.0 (2016-02-17)

Implemented enhancements:

  • Prefix the attributes with "wlv"

Fixed bugs:

  • setProgressValue() increase doesn't conform to logic #8

Update:

  • Update build.gradle
  • Update Sample

0.1.5 (2016-01-14)

Fixed bugs:

  • IllegalArgumentException: width and height must be > 0 while loading Bitmap from View #6

0.1.4 (2015-12-17)

Fixed bugs:

  • setProgressValue() doesn't change the value of mProgressValue #4

0.1.3

Fixed bugs:

  • Attribute "borderWidth" has already been defined #2

Demo

Download

Apps using the WaveLoadingView

Feel free to send me new projects

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

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 2016 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.