kls

KLSwitch

An iOS 7 UISwitch clone that works on iOS 5+

Showing:

Popularity

Downloads/wk

0

GitHub Stars

264

Maintenance

Last Commit

8yrs ago

Contributors

3

Package

Dependencies

0

License

Apache License, Version 2.0

Categories

Readme

KLSwitch

An iOS 7 UISwitch clone that works on iOS 5+

https://www.cocoacontrols.com/controls/klswitch

Requires ARC

## Goal ## 1. Create the iOS 7 UISwitch to be compatible with iOS 5+ 2. Create a drop in replacement for UISwitch

Installation

1. Drag the KLSwitch.xcodeproj to your existing project
2. Under Build Phases on your project's Xcode Project file add 'KLSwitch(KLSwitch)' to your Target Dependancies
3. Under Build on your Xcode Project file add 'libKLSwitch' & QuartzCore.framework under Link Binary With Libraries
4. Include #import <KLSwitch/KLSwitch.h> in any file you wish to use

Via CocoaPods Add the following line to your podfile

pod 'KLSwitch'

Usage

Interface is exactly the same as for the regular UISwitch you know and love (http://developer.apple.com/library/ios/#documentation/uikit/reference/UISwitch_Class/Reference/Reference.html)

Added an event handler block to recieve state changes when the switch is toggled on/off which can be set as follows:

mySwitch.didChangeHandler = ^(BOOL isOn) {
    //Do something useful with it here
}

Or it can be set using the custom initializer

- (id)initWithFrame:(CGRect)frame
   didChangeHandler:(changeHandler) didChangeHandler;
   
   

See Demo project for sample usage using Interface Builder

Config

The visual appearance can be tweaked by changing the constants in KLNoteViewController.m:

//Appearance Defaults - Colors
//Track Colors
#define kDefaultTrackOnColor     [UIColor colorWithRed:83/255.0 green: 214/255.0 blue: 105/255.0 alpha: 1]
#define kDefaultTrackOffColor    [UIColor colorWithWhite: 0.9 alpha:1.0]
#define kDefaultTrackContrastColor [UIColor whiteColor]

//Thumb Colors
#define kDefaultThumbTintColor [UIColor whiteColor]
#define kDefaultThumbBorderColor [UIColor colorWithWhite: 0.9 alpha:1.0]

//Appearance - Layout

//Size of knob with respect to the control - Must be a multiple of 2
#define kKnobOffset 2.0
#define kKnobTrackingGrowthRatio 1.2                //Amount to grow the thumb on press down

#define kDefaultPanActivationThreshold 0.7                    //Number between 0.0 - 1.0 describing how far user must drag before initiating the switch

//Appearance - Animations
#define kDefaultAnimationScaleLength 0.10           //Length of time for the thumb to grow on press down
#define kDefaultAnimationSlideLength 0.25           //Length of time to slide the thumb from left/right to right/left

#define kSwitchTrackContrastViewShrinkFactor 0.00   

Contact

License

Copyrigh 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.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100