https://github.com/KieranLafferty/KLScrollSelect

A scrolling selection view controller based off Expedia 3.0 app
https://github.com/KieranLafferty/KLScrollSelect

Last synced: about 1 month ago
JSON representation

A scrolling selection view controller based off Expedia 3.0 app

• Host: GitHub
• URL: https://github.com/KieranLafferty/KLScrollSelect
• Owner: KieranLafferty
• License: other
• Created: 2013-04-26T22:52:59.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2014-03-26T21:34:45.000Z (over 10 years ago)
• Last Synced: 2024-10-11T02:48:09.823Z (2 months ago)
• Language: Objective-C
• Size: 3.27 MB
• Stars: 182
• Watchers: 15
• Forks: 29
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - KLScrollSelect - A scrolling selection view controller based off Expedia 3.0 app (etc)
• awesome - KLScrollSelect - A scrolling selection view controller based off Expedia 3.0 app (etc)

README

        


KLScrollSelect

=======

A control that infinitely scrolls up and down at variable speeds inspired by Expedia 3.0 app.

Note: KLScrollSelect is intended for use with portrait orientation on iPhone/iPod Touch.

Requires ARC

*Source is dual licensed. Can be used freely without restriction on FREE apps, PAID apps require a license purchased from https://www.cocoacontrols.com/controls/klscrollselect*

[Check out the Demo](http://www.youtube.com/watch?v=uorJfwpTzoI) *Excuse the graphics glitches and lag due to my slow computer.*



    
by MacBuildServer



## Scroll Rate ##

The scroll rate property of each column is measured in [pixel/second] and can be set individually for each column. This value should be set via the KLScrollViewDataSource implementation. Defaults to 10 pixel/second if datasource not implemented

## Installation ##

	1. Drag the KLScrollSelect.xcodeproj to your existing project

	2. Under Build Phases on your project's Xcode Project file add 'KLScrollSelect(KLScrollSelect)' to your Target Dependancies

	3. Under Build on your Xcode Project file add 'libKLScrollSelect' & QuartzCore.framework under Link Binary With Libraries

	4. Include #import  in any file you wish to use

	

	

Via CocoaPods

Add the following line to your podfile

	pod 'KLScrollSelect'

	

## Usage ##

Import the header file and declare your controller to subclass KLScrollViewController

	#import 

	@interface KLViewController : KLScrollSelectViewController

OR, Import the header file and declare your controller to conform to KLScrollSelectDelegate and KLScrollSelectDataSrouce

	#import 

	@interface KLViewController : UIViewController 

Implement the required methods for KLScrollSelectDataSource

	@required

	- (NSInteger)scrollSelect:(KLScrollSelect *)scrollSelect numberOfRowsInColumnAtIndex:(NSInteger)index;

	- (UITableViewCell*) scrollSelect:(KLScrollSelect*) scrollSelect cellForRowAtIndexPath:(NSIndexPath *)indexPath;

	@optional

	- (CGFloat) scrollSelect: (KLScrollSelect*) scrollSelect heightForColumnAtIndex: (NSInteger) index;

	- (CGFloat) scrollRateForColumnAtIndex: (NSInteger) index;

	- (NSInteger)scrollSelect:(KLScrollSelect *)scrollSelect numberOfSectionsInColumnAtIndex:(NSInteger)index;

	// Default is 1 if not implemented

	- (NSInteger)numberOfColumnsInScrollSelect:(KLScrollSelectViewController *)scrollSelect;

	

Implement the optional methods for KLScrollSelectDelegate

	@optional

	- (void)scrollSelect:(KLScrollSelect *)tableView didSelectCellAtIndexPath:(NSIndexPath *)indexPath;

NSIndexPath Add-on

Implements a category which adds *column* to NSIndexPath. This allows NSIndexPath to identify which cell in which column as follows:

	 

	column: Identifies to column in the KLScrollView

	section: Identifies the section (As one would expect with UITableView column on NSIndexPath)

	row: Identifies the row (As one would expect with UITableView row on NSIndexPath)

## Contact ##

* [@kieran_lafferty](https://twitter.com/kieran_lafferty) on Twitter

* [@kieranlafferty](https://github.com/kieranlafferty) on Github

* kieran.lafferty [at] gmail [dot] com

## License ##

Copyright 2013 Kieran Lafferty

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.