:octocat: 🔍 RAMReel is a UI controller that allows you to choose options from a list. Swift UI library made by @Ramotion - https://dev.ramotion.com/gthbr
Clone or download
Latest commit e9b9bd3 Dec 10, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
RAMReel.xcodeproj convert to swift Sep 17, 2018
RAMReel convert to swift Sep 17, 2018
RAMReelExample.xcworkspace Project fixes Apr 24, 2015
RAMReelExample convert to swift Sep 17, 2018
docs update docs Oct 17, 2016
.gitignore Podspec fixes Apr 24, 2015
.travis.yml update travis build config Jan 18, 2018
CHANGELOG.md CHANGELOG.md May 30, 2016
CONTRIBUTING.md add contributing guide, add badges and update docs Jan 29, 2016
LICENSE Initial commit Apr 2, 2015
Package.swift Adding SPM specs Feb 1, 2016
RAMReel.podspec update podspec Sep 17, 2018
README.md Update README.md Dec 10, 2018
Sources Adding SPM specs Feb 1, 2016
header.png add header Feb 10, 2016
reel-search.gif Add files via upload Apr 28, 2018




Swift 4.0 CocoaPods CocoaPods Carthage compatible codebeat badge Travis Twitter Donate


This project is maintained by Ramotion, Inc.
We specialize in the designing and coding of custom UI for Mobile Apps and Websites.

Looking for developers for your project?
This project is maintained by Ramotion, Inc. We specialize in the designing and coding of custom UI for Mobile Apps and Websites.

The iPhone mockup available here.


  • iOS 8.0+
  • Swift 4.0


We recommend using CocoaPods to install our library.

Just put this in your Podfile:

pod 'RAMReel'

or Carthage users can simply add reel-search to their Cartfile:

github "Ramotion/reel-search"


In order to use our control you need to implement the following:


Now you can use those types as generic parameters of type declaration of RAMReel:

RAMReel<CellClass, TextFieldClass, DataSource>


Next you need to create an instance of RAMReel, and for that you need the following:

  • frame: CGRect: Rect, specifying where you want to put the control.
  • dataSource: DataSource: the source of data for the reel.
  • placeholder: String (optional): Placeholder text; by default, an empty string is used.
  • hook: DataSource.ResultType -> Void (optional): Action to perform on element selection, nil by default. You can add additional hooks later, if you need multiple actions performed.

Let's use it to create an instance of RAMReel:

let ramReel = RAMReel<CellClass, TextFieldClass, DataSource>(frame: frame, dataSource: dataSource, placeholder: placeholder, hook: hook)

Adding action hooks

To add extra actions you may append DataSource.ResultType -> Void functions to RAMReel object property hooks:

ramReel.hooks.append { data in
	// your code goes here

Putting on the view

And the final step, showing RAMReel on your view:

ramReel.view.autoresizingMask = [.FlexibleWidth, .FlexibleHeight]

If you have visual problems, try calling prepareForViewing before showing your view.

Like this:

override func viewDidLayoutSubviews() {


If you want to change RAMReel look and feel, you can use theming.

To do so, you just to have to implement the Theme protocol in your class/structure and set your RAMReel object's theme property to your theme.

Or you can just use the predefined instance of type RAMTheme.

let textColor: UIColor
let listBackgroundColor: UIColor
let font: UIFont

let theme = RAMTheme(textColor: textColor, listBackgroundColor: listBackgroundColor, font: font)



See more at RAMReel docs

This library is a part of a selection of our best UI open-source projects.

Get the Showroom App for iOS to give it a try

Try this UI component and more like this in our iOS app. Contact us if interested.

Follow us for the latest updates