DKImageBrowser 0.1.5

You want to add pod 'DKImageBrowser', '~> 0.1' similar to the following to your Podfile:

target 'MyApp' do
  pod 'DKImageBrowser', '~> 0.1'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try DKImageBrowser

DKImageBrowser 0.1.5

By
dkhamsing
dkhamsing

iOS controller to display images (URL or UIImage) alongside a strip of thumbnails

Installation

Manual

Drag DKImageBrowser/DKImageBrowser to your project.
#import "DKImageBrowser.h" (or #import "DKModalImageBrowser.h")

Usage

Set up the data source array and pass it to an instance of DKImageBrowser.

    DKImageBrowser *imageBrowser = [[DKImageStripController alloc] init];
    imageBrowser.DKImageDataSource =  @[ @"http://placekitten.com/230/400",
                                         @"http://placekitten.com/240/400"], ];
    [self.navigationController pushViewController:imagesController animated:YES];

The data source DKImageDataSource can also be a list of UIImage objects.

    imageBrowser.DKImageDataSource = @[ [UIImage imageNamed:@"400-1.jpg"],
                                        [UIImage imageNamed:@"400-2.jpg"], ];

To present the controller modally, use DKModalImageBrowser.

    DKModalImageBrowser *modalImageBrowser = [[DKModalImageBrowser alloc] init];    
    // note: use modalImageBrowser.imageBrowser to set data source, customize
    modalImageBrowser.imageBrowser.DKImageDataSource = @[ [UIImage imageNamed:@"400-1.jpg"],
                                                          [UIImage imageNamed:@"400-2.jpg"], ];
    [self presentViewController:modalImageBrowser animated:YES completion:nil];

Swift

    func actionDefault() {
        let imageBrowser = DKImageBrowser()
        imageBrowser.title = "UIImage Data Source"

        let imageDataSource: [UIImage] = [
            UIImage(named: "400-1.jpg")!,
            UIImage(named: "400-2.jpg")!,
        ]
        imageBrowser.DKImageDataSource = imageDataSource

        self.navigationController?.pushViewController(imageBrowser, animated: true)
    }

    func actionCustom() {
        var kittenDataSource: [NSString] = []
        let imageHeight = 416
        let imageWidth = Int(self.view.bounds.size.width - 20)

        for index in 1...10 {
            let placeKitten = "http://placekitten.com/\(imageWidth + (index * 2  + 10))/\(imageHeight)" as NSString
            kittenDataSource.append(placeKitten)
        }

        let modalImageBrowser = DKModalImageBrowser()
        modalImageBrowser.title = "URL Data Source"

        modalImageBrowser.imageBrowser.DKImageDataSource = kittenDataSource
        modalImageBrowser.imageBrowser.DKImagePadding = 5
        modalImageBrowser.imageBrowser.DKThumbnailStripHeight = 110
        modalImageBrowser.imageBrowser.DKBackgroundColor = UIColor.blackColor()
        modalImageBrowser.imageBrowser.DKThumbnailStripPosition = 0
        modalImageBrowser.imageBrowser.DKStartIndex = 2

        self.presentViewController(modalImageBrowser, animated: true, completion: nil)
    }

Customization

DKBackgroundColor Background color of the image browser. The default is white.
DKImagePadding Padding around the images. The default is 20.
DKImageWidth Width of the main image being displayed. The default is the width of the screen -100.
DKStartIndex Starting image index. The default is 0 (first image).
DKThumbnailStripHeight Height of the thumbnail strip. The default is 100.
DKThumbnailStripPosition Position of the thumbnail strip, either DKThumbnailStripPositionTop or DKThumbnailStripPositionBottom. The default is DKThumbnailStripPositionBottom.

Demo

DKImageBrowser includes Swift and Objective-C demo projects.

Compatibility

This project was tested with iOS 9.

Contact

License

DKImageBrowser is available under the MIT license. See the LICENSE file for more info.