KProgressHUD

Additional

Language
Java
Version
1.0 (Dec 29, 2015)
Created
Dec 23, 2015
Updated
Aug 7, 2018
Owner
Kaopiz Software Co., Ltd. (Kaopiz)
Contributors
Jonas Schmid (jschmid)
Le Van Hoang (hoang8f)
tuanna-hsp
gengjiawen
Null-Ouwenjie
evgeny-sureev
gradha
zhouyoufa
narxeba
9
Activity
Badge
Generate
Download
Source code
APK file

Advertising

KProgressHUD

An implement of ProgressHUD for Android, similar to MBProgressHUD, SVProgressHUD. Inspired by MBProgressHUD for iOS.

Compatibility

Android 2.3 and later

Adding KProgressHUD to your project

Gradle

Include this in your module build.gradle

dependencies {
    // Other dependencies
    implementation 'com.kaopiz:kprogresshud:1.2.0'
}

Source code

You can download and import the kprogresshud folder as module to your project.

Usage

The usage of KProgressHUD is pretty straight forward. You create the HUD, customize its style and show it on the UI thread. Then fire a background thread to work on long-running tasks. When done, call dismiss() to close it (if you use a determinate style, the HUD will automatically dismiss if progress reaches its max).

Indeterminate HUD

KProgressHUD.create(MainActivity.this)
 .setStyle(KProgressHUD.Style.SPIN_INDETERMINATE)
 .setLabel("Please wait")
 .setDetailsLabel("Downloading data")
 .setCancellable(true)
 .setAnimationSpeed(2)
 .setDimAmount(0.5f)
 .show();

Determinate HUD

KProgressHUD hud = KProgressHUD.create(MainActivity.this)
     .setStyle(KProgressHUD.Style.ANNULAR_DETERMINATE)
     .setLabel("Please wait")
     .setMaxProgress(100)
     .show();
hud.setProgress(90);

Alternatively, you can create a custom view and pass to the HUD to display it.

ImageView imageView = new ImageView(this);
imageView.setBackgroundResource(R.drawable.spin_animation);
AnimationDrawable drawable = (AnimationDrawable) imageView.getBackground();
drawable.start();
KProgressHUD.create(MainActivity.this)
   .setCustomView(imageView)
   .setLabel("This is a custom view")
   .show();

Optionally, the custom view can implement Determinate or Indeterminate interface, which make the HUD treats this view like the default determinate or indeterminate one.

See Javadocs or sample for more information.

Contributing

  1. Fork it ( https://github.com/Kaopiz/KProgressHUD/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

   Copyright 2015 Kaopiz Software Co., Ltd.

   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.