Skip to content
Projects

skx926/KSPhotoBrowser

View on GitHub

skx926/KSPhotoBrowser has 757 GitHub stars and 129 forks. GitHot measured -3 stars in 24 hours. Last checked 2026-11-20 18:19 UTC. Last push 2020-10-04.

How these counts are measured

What you can do

  • 4 different interactive dismissal animations (Rotation, Scale, Slide)
  • 3 different background styles (Blur Photo, Blur, Black)
  • 2 different loading styles (Determinate, Indeterminate)
  • 2 different pager styles (Dot, Text)

Measured star growth

in 24h
-3
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A beautiful photo browser with interactive dismissal animation.一个小而美的图片浏览器。

Creative & Media

README.md

Original

KSPhotoBrowser

License MIT  CocoaPods  CocoaPods  Support 

A beautiful photo browser with interactive dismissal animation.

Rotation~ Blur~ Scale~ Corner~ Orientation~ Index~

Features

  • 4 different interactive dismissal animations (Rotation, Scale, Slide)
  • 3 different background styles (Blur Photo, Blur, Black)
  • 2 different loading styles (Determinate, Indeterminate)
  • 2 different pager styles (Dot, Text)
  • Support bounce animation
  • Optimized for image which has a very large height
  • Can display one or more images by providing either image urls or UIImage objects
  • Custom image downloader library support
  • Smooth animation with corner radius
  • Support both portrait and landscape device orientation
  • Support video browse

Usage

Display images from urls

NSArray *urls = @[@"https://ww4.sinaimg.cn/bmiddle/a15bd3a5jw1f12r9ku6wjj20u00mhn22.jpg",
                  @"https://ww2.sinaimg.cn/bmiddle/a15bd3a5jw1f01hkxyjhej20u00jzacj.jpg"];
NSMutableArray *items = @[].mutableCopy;
for (int i = 0; i < urls.count; i++) {
    // Get the large image url
    NSString *url = [urls[i] stringByReplacingOccurrencesOfString:@"bmiddle" withString:@"large"];
    UIImageView *imageView = _imageViews[i];
    KSPhotoItem *item = [KSPhotoItem itemWithSourceView:imageView imageUrl:[NSURL URLWithString:url]];
    [items addObject:item];
}
KSPhotoBrowser *browser = [KSPhotoBrowser browserWithPhotoItems:items selectedIndex:0];
[browser showFromViewController:self];

Display images from UIImage objects

NSArray *names = @[@"a.jpg", @"b.jpg"];
NSMutableArray *items = @[].mutableCopy;
for (int i = 0; i < names.count; i++) {
    UIImageView *imageView = _imageViews[i];
    KSPhotoItem *item = [KSPhotoItem itemWithSourceView:imageView image:[UIImage imageNamed:names[i]]];
    [items addObject:item];
}
KSPhotoBrowser *browser = [KSPhotoBrowser browserWithPhotoItems:items selectedIndex:0];
[browser showFromViewController:self];

Installation

Cocoapods

  1. Update cocoapods to the latest version.
  2. Add pod 'KSPhotoBrowser' to your Podfile.
  3. Run pod install or pod update.
  4. Import KSPhotoBrowser.h.

Manually

  1. Download all the files of KSPhotoBrowser and add source files to your project.
  2. Manually install SDWebImage to your project.
  3. Import KSPhotoBrowser.h.

Custom Image Downloader

It use SDWebImage as default image downloader, you can also use your custom image downloader like YYWebImage, Kingfisher and so on.

To use a custom image downloader, you need to create a class and make it conforms to KSImageManagerProtocol and implement those methods inside that protocol.

For convenience, I have already created KSYYImageManager to support YYWebImage as an example in the demo, you can also use it directly.

Finally, just use the code below to set your class to KSPhotoBrowser before you use the browser to show images.

[KSPhotoBrowser setImageManagerClass:KSYYImageManager.class]

Requirements

This library requires iOS 8.0+ and Xcode 8.0+.

License

KSPhotoBrowser is provided under the MIT license. See LICENSE file for details.