Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nikkovios/sdwebimage-circularprogressview

Circular progress view category for SDWebImage. [Not supported anymore]
https://github.com/nikkovios/sdwebimage-circularprogressview

circular-indicator image-loader image-loading sdwebimage uiprogressview

Last synced: about 2 months ago
JSON representation

Circular progress view category for SDWebImage. [Not supported anymore]

Host: GitHub
URL: https://github.com/nikkovios/sdwebimage-circularprogressview
Owner: NikKovIos
License: mit
Created: 2016-08-08T13:03:20.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2022-11-03T16:02:47.000Z (about 2 years ago)
Last Synced: 2024-04-24T13:16:12.385Z (9 months ago)
Topics: circular-indicator, image-loader, image-loading, sdwebimage, uiprogressview
Language: Objective-C
Homepage:
Size: 76.2 KB
Stars: 32
Watchers: 5
Forks: 11
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE

Awesome Lists containing this project

README

        # SDWebImage-CircularProgressView

![Cocoapods](https://img.shields.io/badge/pod-available-brightgreen.svg?style=flat)

![Platform](https://img.shields.io/badge/platform-ios-blue.svg?style=flat)

![Version](https://img.shields.io/badge/version-1.1-blue.svg?style=flat)

![Objective-C version](https://img.shields.io/badge/Objective--C-latest-lightgrey.svg?style=flat)

![License](https://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat)

 

Good day everybody!)  

This is a category to SDWebImage that offer you to add ProgressView in three ways:

- Circular (using [DACircularProgress](https://github.com/danielamitay/DACircularProgress))

- Linear

- Custom  

Images are downloading by SDWebImage (3.7.0 and up)

## SCREENSHOTS

![Screenshot_here](https://github.com/NikKovV/SDWebImage-CircularProgressView/blob/master/Screenshots/NKVProgressView.png "Screenshot")

## Installation

[Cocoapods](http://cocoapods.org):

```

pod 'SDWebImage-CircularProgressView'

```

## Code examples

There are two parameters and unique prefix to easier finding. 

- `progressViewType` - LinearPV or CircularPV. Choose the type of Progress View.

- `progressView` - If you init your own UIProgressView than put it there. It should be a class or subclass of UIProgressView.

```

- (void)nkv_setImageWithURL:(NSURL *)url usingProgressViewType:(ProgressViewType)progressViewType orCustomProgressView:(UIProgressView *)progressView;

- (void)nkv_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder usingProgressViewType:(ProgressViewType)progressViewType orCustomProgressView:(UIProgressView *)progressView;

- (void)nkv_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options usingProgressViewType:(ProgressViewType)progressViewType orCustomProgressView:(UIProgressView *)progressView;

- (void)nkv_setImageWithURL:(NSURL *)url completed:(SDWebImageCompletionBlock)completedBlock usingProgressViewType:(ProgressViewType)progressViewType orCustomProgressView:(UIProgressView *)progressView;

- (void)nkv_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder completed:(SDWebImageCompletionBlock)completedBlock usingProgressViewType:(ProgressViewType)progressViewType orCustomProgressView:(UIProgressView *)progressView;

- (void)nkv_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDWebImageCompletionBlock)completedBlock usingProgressViewType:(ProgressViewType)progressViewType orCustomProgressView:(UIProgressView *)progressView;

- (void)nkv_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionBlock)completedBlock usingProgressViewType:(ProgressViewType)progressViewType orCustomProgressView:(UIProgressView *)progressView;

```

#### cancelCurrentImageLoad

If you're using the `sd_cancelCurrentImageLoad method`, you'll also have to call removeProgressView.

```

- (void)prepareForReuse {

    [super prepareForReuse];

    [self.imageView sd_cancelCurrentImageLoad];

    [self.imageView removeProgressView];

}

```

#### Customize UIProgressView by DataSource methods

1. `#import "UIImageView+CircularProgressView.h"`

2. `@interface NKVTableCell () `

3. `[self.bodyImageV nkvSetProgressViewDataSource:self];`

4. `[self.bodyImageV nkv_setImageWithURL:url usingProgressViewType:CircularPV orCustomProgressView:nil];`

5. In self (DataSource's class) implement method:

```

- (CircularProgressViewSettings *)setupCircularProgressViewSettings

{

    CircularProgressViewSettings *circularSettings = [CircularProgressViewSettings new];

    circularSettings.progressTintColor = [UIColor redColor];

    circularSettings.thicknessRatio = 0.2;

    return circularSettings;

}

```

#### Customize all UIProgressViews in app

```

[DACircularProgressView appearance].trackTintColor = [UIColor lightGrayColor];

[DACircularProgressView appearance].progressTintColor = [UIColor blackColor];

[UIProgressView appearance].trackTintColor = [UIColor lightGrayColor];

[UIProgressView appearance].progressTintColor = [UIColor blackColor];

```

## You should know

- It uses SDWebImage and DACircularProgress.

- CirclePV type implements transparent view by default. Use appearance in AppDelegate or somewhere else to customize it.

- Custom progress bar is a priority for other types. Otherwords if you choose `LinearPV` and then add `orCustomProgressView:(UIProgressView*)yourCustomProgressView` than it would be your custom ProgressView.

### References

Inspired by projects:

- https://github.com/kevinrenskers/SDWebImage-ProgressView

- https://github.com/danielamitay/DACircularProgress

#### TODO:

- [x] Add http://shields.io/

- [ ] Add example

- [ ] Add UIedgeInsets like property

- [ ] Add refresh button to image 

- [ ] Think about default settings for CircleV

## My other Repos

- [x] https://github.com/NikKovIos/ObjectMapper_RealmSwift - extension to add Realm object support for ObjectMapper

- [x] https://github.com/NikKovIos/NKVPhonePicker - UITextField subclass picker for country phone codes

### by Nik Kov