ACProgressLite

English Version / 中文版本

An Android loading widget library. Lite and easy to use, strong customizability. Can be used to implement 'iOS' like loading dialog efficiently.

Similar to iOS MBProgressHUD

Keywords Progressbar, Progresswheel, HUD, Android, Loading

Minimum SDK Version: API 9 ( Android 2.3 )

Sample APK download

Current Version

• 1.2.1

Usage

• gradle: compile 'cc.cloudist.acplibrary:library:1.2.1'

Sample Code

• Flower

ACProgressFlower dialog = new ACProgressFlower.Builder(this)
                        .direction(ACProgressConstant.DIRECT_CLOCKWISE)
                        .themeColor(Color.WHITE)
                        .text("Title is here")
                        .fadeColor(Color.DKGRAY).build();
dialog.show();

• Pie

ACProgressPie dialog = new ACProgressPie.Builder(this)
                     .ringColor(Color.WHITE)
                     .pieColor(Color.WHITE)
                     .updateType(ACProgressConstant.PIE_AUTO_UPDATE)
                     .build();
dialog.show();

• Custom

ACProgressCustom dialog = new ACProgressCustom.Builder(this)
                        .useImages(R.drawable.p0, R.drawable.p1, R.drawable.p2, R.drawable.p3)
                        .build();
dialog.show();

Configuration

 3 types of dialog are avaliable now:

 Here are some general configurations:

1. sizeRatio size of the background. The value is float and less than 1f. It means the ratio of "real size / the smaller edge length of the screen". aka:
   background length = the smaller edge length of the screen * sizeRatio

Pay attention to the situation of "Flower type with text", it will be explained int next scetion.

1. bgColor Color of background, int value.
2. bgAlpha Transparency of background. 0 is full transparency, 1 is opaque. All alpha configurations are similar.
3. bgCornerRadius Radius of four corners of the background.

bgColor, bgAlpha, bgCornerRadius are not available for custom type

• Flower
  Most commonly used type. Support adding text title.

• Pie
  Suitable for display progress. Manual-update and auto-update are supported.

• Custom
  like GIF, support res/drawable resources ids array or image files array as data source.

Notice

• Try to clean the project first when you come across any problem.
• use setCanceledOnTouchOutside(true) in version 1.2.0+ when you want to dismiss the dialog when touch outside.
• Most of the methods in Dialog are supported.
• We strongly suggest you to use version above 1.2.0
• If you use version before 1.1.0 (without 1.1.0),and gradle error occured, you can add tools:ignore="label under tag application in Manifest to solve it.
• Don not try to use useImages and useFiles at the same time, or only the last calling is avaliable.
• Default configuration can perform well under most situations. If you really want to do customization, please tweak carefully to get best visual performance.
• I'm not a native English speaker, there may be some grammar mistakes in this file. Suggestions and corrections are welcome.

License

• MIT License