iOS (RubyMotion) Horizontal Scroll Controller
This is a horizontal scroll controller for iOS, that mimics the Pulse UI. The basic functionality is borrowed from a codebase and it is the reason why we were able to come up with this gem, so hats off to the authors! Also, a ton of thanks to lorempixel from where we have pulled in images to feed the sample app.
Add this line to your application's Gemfile:
And then execute:
A sample app is included for reference. To get it up and running, simply clone the
repository and run
rake device depending on whether you want
to preview it in the simulator or device.
Using in your app
Nevertheless, the basic setup for a single row can be achieved as follows:
horizontal_row = HorizontalTableContainerCell.alloc.initWithStyle(UITableViewCellStyleSubtitle, reuseIdentifier: <REUSE_IDENTIFIER>) horizontal_row.delegate = <DELEGATE> horizontal_row.vertical_row_offset = <VERTICAL_ROW_OFFSET> cell = horizontal_row.set_dimensions_with_row_offset cell.items_list = <DATA ARRAY> cell.selectionStyle = UITableViewCellSelectionStyleNone cell
Supplying the title and image
The data required for a single cell has two properties, namely a name and an image. The name is the title that appears underneath the image in the cell. The image itself can be fed in two formats:
An instance of UIImage with initialized with an image.
A URL to an image along with a placeholder image; this requires either the gem afmotion or the pod AFNetworking. The pod on its own may be insufficient, but there's a category called UIImageView+AFNetworking that can start an asynchronous download of an image when given an NSURLRequest.
Available delegate methods
This refers to a callback that indicates a particular cell has been tapped. The syntax of the method for the same is as follows:
Setting Cell Details
The specifics of a cell that need to be set are the title and image. The delegate method for setting cell details is:
To set the cell title, you can use the following method:
To set the image, there are two possible methods based on the format as specified above.
The first method involves directly providing an instance of UIImage:
cell.set_thumbnail_image image # image is an instance of UIImage ```
And the second is probably the method that would be more commonly used for apps that use images pulled from a network. This would require the
setImageWithURLmethod for the
UIImageViewclass which can be availed by installing the
afmotiongem (in Objective-C, this would be available in the
UIImageView+AFNetworkingcategory). The two arguments it takes are the URL to the image and the name of a locally available placeholder image. The syntax is:
cell.set_thumbnail_image_with_url image_url, placeholder # image_url is a URL in form of a string and the placeholder is a local image that can take the place of the image until it loads ```
iOS (RubyMotion) Horizontal Scroll Controller is Copyright (c) 2016 Multunus Software Pvt. Ltd. It is free software, and may be redistributed under the terms specified in the LICENSE file.
iOS (RubyMotion) Horizontal Scroll Controller is maintained and funded by Multunus Software Pvt. Ltd. The names and logos for Multunus are trademarks of Multunus Software Pvt. Ltd.