Intoduction
🏞 MediaBrowser can display one or more images or videos by providing either UIImage
objects, PHAsset
objects, or URLs
to library assets, web images/videos or local files. MediaBrowser handles the downloading and caching of photos from the web seamlessly. Photos can be zoomed and panned, and optional (customisable) captions can be displayed. This can also be used to allow the user to select one or more photos using either the grid or main image view.
Also, MediaBrowser use latest SDWebImage version for caching, motivated by MWPhotoBrowser
Single Photo | Multiple Photos And Video |
---|---|
Multiple Photo Grid | Multiple Photo Selection |
Web Photos | Web Photos Grid |
Requirements
MediaBrowser
is written in Swift 3. Compatible with iOS 8.1+
Usage
Basic
Get MediaBrowser
and set MediaBrowserDelegate
let browser = MediaBrowser(delegate: self)
self.navigationController?.pushViewController(browser, animated: true)
//MediaBrowserDelegate
func numberOfMedia(in mediaBrowser: MediaBrowser) -> Int {
return mediaArray.count
}
func media(for mediaBrowser: MediaBrowser, at index: Int) -> Media {
if index < mediaArray.count {
return mediaArray[index]
}
return DemoData.localMediaPhoto(imageName: "MotionBookIcon", caption: "Photo at index is Wrong")
}
Advanced
MediaBrowser
Property | Type |
---|---|
navigationBarTranslucent | Bool |
navigationBarTextColor | UIColor |
navigationBarTintColor | UIColor |
statusBarStyle | UIStatusBarStyle |
toolbarTextColor | UIColor |
toolbarBarTintColor | UIColor |
toolbarBackgroundColor | UIColor |
hasBelongedToViewController | Bool |
isVCBasedStatusBarAppearance | Bool |
statusBarShouldBeHidden | Bool |
displayActionButton | Bool |
leaveStatusBarAlone | Bool |
performingLayout | Bool |
rotating | Bool |
viewIsActive | Bool |
didSavePreviousStateOfNavBar | Bool |
skipNextPagingScrollViewPositioning | Bool |
viewHasAppearedInitially | Bool |
currentGridContentOffset | CGPoint |
zoomPhotosToFill | Bool |
displayMediaNavigationArrows | Bool |
displaySelectionButtons | Bool |
alwaysShowControls | Bool |
enableGrid | Bool |
enableSwipeToDismiss | Bool |
startOnGrid | Bool |
autoPlayOnAppear | Bool |
hideControlsOnStartup | Bool |
delayToHideElements | TimeInterval |
captionAlpha | CGFloat |
toolbarAlpha | CGFloat |
loadingIndicatorInnerRingColor | UIColor |
loadingIndicatorOuterRingColor | UIColor |
loadingIndicatorInnerRingWidth | CGFloat |
loadingIndicatorOuterRingWidth | CGFloat |
loadingIndicatorFont | UIFont |
loadingIndicatorFontColor | UIColor |
loadingIndicatorShouldShowValueText | Bool |
mediaSelectedOnIcon | UIImage? |
mediaSelectedOffIcon | UIImage? |
mediaSelectedGridOnIcon | UIImage? |
mediaSelectedGridOffIcon | UIImage? |
Installation
Cocoapods
pod 'MediaBrowser'
Carthage
github "younatics/MediaBrowser"
References
Please tell me or make pull request if you use this library in your application :)
Updates
See CHANGELOG for details
Author
License
MediaBrowser is available under the MIT license. See the LICENSE file for more info.