Giter Club home page Giter Club logo

obslider's Introduction

OBSlider

A UISlider subclass that adds variable scrubbing speeds (as seen in the iPod app on iOS) to UISlider.

Written by Ole Begemann, January 2011.

Usage

Copy OBSlider.h and OBSlider.m to your project and instantiate an OBSlider wherever you would use a UISlider. If you create the slider in Interface Builder, set its class to OBSlider on the Identity tab.

The slider works with variable scrubbing speeds out of the box. In the action method you have assigned to UIControlEventValueChanged, you can access the scrubbingSpeed variable to get the current scrubbing speed. Scrubbing scrubbingSpeedis afloatwhere1.0f` is the normal scrubbing speed.

To modify which scrubbing speed should be set at which vertical offset position of the user's touch, you can modify the scrubbingSpeeds and scrubbingSpeedChangePositions arrays. Both arrays should contain the same number of objects. scrubbingSpeedChangePositions should indicate the vertical offsets at which scrubbing speed changes should take place in ascending order. The first entry in this array should always be [NSNumber numberWithFloat:0.0f]. scrubbingSpeeds should contain the actual values for the scrubbing speed that correspond to the offset positions.

The default values for the two arrays are:

scrubbingSpeeds = [NSArray arrayWithObjects:
 [NSNumber numberWithFloat:1.0f],
 [NSNumber numberWithFloat:0.5f],
 [NSNumber numberWithFloat:0.25f],
 [NSNumber numberWithFloat:0.1f],
 nil];

scrubbingSpeedChangePositions = [NSArray arrayWithObjects:
 [NSNumber numberWithFloat:0.0f],
 [NSNumber numberWithFloat:50.0f],
 [NSNumber numberWithFloat:100.0f],
 [NSNumber numberWithFloat:150.0f],
 nil];

(That is, scrubbing speed changes from 100% to 50% to 25% to 10% when the user moves the finger upward/downward by 50.0/100.0/150.0 points, respectively.)

Requirements

OBSlider 1.0.0 (tagged with 1.0.0) works in iOS 3.0+.

With version 1.1.0 (tagged 1.1.0) I converted the source code to Automatic Reference Counting (ARC) and raised the deployment target of the demo app to iOS 5.0. If you want to support earlier iOS versions, please check out the 1.0.0 tag.

Demo

Open the demo project OBSliderDemo.xcodeproj in Xcode and run it on an iPhone or the iPhone Simulator. Drag the slider around and, while dragging, move your finger upwards/downwards to adjust the scrubbing speed.

Untested

The class is basically untested. Please report bugs via the issue tracker on GitHub.

License

Licensed under the MIT license. You can use the code in your commercial and non-commercial projects.

Contributors

  • Ole Begemann
  • David Linsin: iOS 3.x compatibility
  • Sylver Bruneau: iPod.app-like slider behavior (as you drag towards the slider, the thumb meets your finger at the slider)
  • Brad Sokol: Position the thumb more precisely when the user drags their finger back towards the slider

Thanks!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.