GifCollectionView

CocoaPods

Drop in GIF Collection View. Uses Tenor as default GIFs provider. This will allow you to easily integrate GIF image search into your app or you can use this as a GIF keyboard for your messaging needs.

You can also implement your own GifProvider with another GIF service (e.g: GIPHY) and supply the provider to GifCollectionView.

Demo

Requirements

  • iOS 12.0+ | macOS 10.15+
  • Xcode 13

Integration

CocoaPods (iOS 12.0+, OS X 10.15+)

You can use CocoaPods to install GifCollectionView by adding it to your Podfile:

platform :ios, '12.0'
use_frameworks!

target 'MyApp' do
    pod 'GifCollectionView'
end

Usage

Initialization

import GifCollectionView

Simply initialize GifCollectionView like any other view and provide appropriate constraints.

gifCollectionView = GifCollectionView.init()
gifCollectionView.delegate = self
view.addSubview(gifCollectionView)

In order to load Gifs using Tenor you must supply your own Tenor API Key.

gifCollectionView.setTenorApiKey(apiKey: "YOUR_TENOR_API_KEY")
gifCollectionView.startLoadingGifs()

Or you can supply your own Gifs provider by conforming to GifProvider protocol

gifCollectionView.replaceProvider(<#T##provider: GifProvider##GifProvider#>)
gifCollectionView.startLoadingGifs()

You can receive callbacks for selected images using GifCollectionViewDelegate.

public protocol GifCollectionViewDelegate: AnyObject {
    func didSelectGifItem(gifItem: GifItem)
    func scrollViewDidScroll(_ scrollView: UIScrollView)
}

Questions

If you have questions on how to integrate GifCollectionView into your project, feel free to create an issue and we’ll try to help the best we can. Pull Requests and bug fixes are wellcome.

Apps using GifCollectionView

If you have an app using GifCollectionView, let me know and I’ll link to it here.

GitHub

View Github