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

Category on UIImageView, adding a progress view while images are downloaded using SDWebImage.
https://github.com/kevinrenskers/SDWebImage-ProgressView

Last synced: about 1 month ago
JSON representation

Category on UIImageView, adding a progress view while images are downloaded using SDWebImage.

• Host: GitHub
• URL: https://github.com/kevinrenskers/SDWebImage-ProgressView
• Owner: kevinrenskers
• License: mit
• Created: 2013-06-07T12:34:10.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2021-07-19T20:21:02.000Z (over 3 years ago)
• Last Synced: 2024-10-15T10:45:27.044Z (about 2 months ago)
• Language: Objective-C
• Homepage:
• Size: 12.7 KB
• Stars: 140
• Watchers: 10
• Forks: 24
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mobile-ui - kevinrenskers/SDWebImage-ProgressView

README

        
# SDWebImage-ProgressView

Category on UIImageView, adding a progress view while images are downloaded using SDWebImage (3.7.0 and up).  

[Example on Youtube](http://www.youtube.com/watch?v=qfZrOYYLOPc)

## Installation

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

```

pod 'SDWebImage-ProgressView'

```

## Usage

All of SDWebImage's UIView+WebCache methods gained an extra parameter:

```

- (void)sd_setImageWithURL:(NSURL *)url usingProgressView:(UIProgressView *)progressView;

- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder usingProgressView:(UIProgressView *)progressView;

- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options usingProgressView:(UIProgressView *)progressView;

- (void)sd_setImageWithURL:(NSURL *)url completed:(SDWebImageCompletedBlock)completedBlock usingProgressView:(UIProgressView *)progressView;

- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder completed:(SDWebImageCompletedBlock)completedBlock usingProgressView:(UIProgressView *)progressView;

- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDWebImageCompletedBlock)completedBlock usingProgressView:(UIProgressView *)progressView;

- (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletedBlock)completedBlock usingProgressView:(UIProgressView *)progressView;

```

Use `nil` for the `progressView` parameter to use the system default `UIProgressView`, or provide your own progress view (or subclass thereof) if you want custom styling and tint colors.

If you're using the `sd_cancelCurrentImageLoad` method, you'll also have to call `removeProgressView` or you'll end up with lingering progress views.

```

- (void)prepareForReuse {

    [super prepareForReuse];

    [self.imageView sd_cancelCurrentImageLoad];

    [self.imageView removeProgressView];

}

```

## Thanks

The idea for this project came from [UIActivityIndicator-for-SDWebImage](https://github.com/JJSaccolo/UIActivityIndicator-for-SDWebImage). A big thank you goes to Giacomo Saccardo.

## License

SDWebImage-ProgressView is available under the MIT license. See the LICENSE file for more info.