Skip to content

A Customizable Switch UI for iOS, Inspired from Google's Material Design

License

Notifications You must be signed in to change notification settings

JunichiT/JTMaterialSwitch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JTMaterialSwitch

CI Status Version License Platform

Overview

JTMaterialSwitch is google's material design like switch UI with animation features.

This library has cool and sophisticated animations, ripple effect and bounce effect. Also, customizable properties can be tweaked behaviors and enhance your application UI cool.

With this library, you can easily implement material design switch to your app.



Installation

JTMaterialSwitch is available on CocoaPods.

You can use this library by adding the following command onto your Podfile:

pod "JTMaterialSwitch"

Usage

The simplest setup:

  JTMaterialSwitch *switch = [[JTMaterialSwitch alloc] init];
  switch.center = CGPointMake(200, 200);
  [self.view addSubview:switch];

This is the simplest and easiest initialization. The style, size and initial state of JTMaterialSwitch instance is set to all default value as shown below.

In addition, this library also has following designated initializers to set these parameters.

 /**
  *  Initializes a JTMaterialSwitch with a initial switch state position and size.
  *
  *  @param size A JTMaterialSwitchSize enum as this view's size(big, normal, small)
  *  @param state A JTMaterialSwitchState enum as this view's initial switch pos(ON/OFF)
  *
  *  @return A JTMaterialSwitch with size and initial position
  */
 - (id)initWithSize:(JTMaterialSwitchSize)size state:(JTMaterialSwitchState)state;

 /**
  *  Initializes a JTMaterialSwitch with a initial switch size, style and state.
  *
  *  @param size A JTMaterialSwitchSize enum as this view's size(big, normal, small)
  *  @param state A JTMaterialSwitchStyle enum as this view's initial style
  *  @param state A JTMaterialSwitchState enum as this view's initial switch pos(ON/OFF)
  *
  *  @return A JTMaterialSwitch with size, style and initial position
  */
- (id)initWithSize:(JTMaterialSwitchSize)size style:(JTMaterialSwitchStyle)style state:(JTMaterialSwitchState)state;

Customize Behaviors

JTMaterialSwitch has many prateters to customize behaviors as you like.

Style and size

  • Style: JTMaterialSwitchStyle

  • JTMaterialSwitchStyleLight

  • JTMaterialSwitchStyleDark

  • JTMaterialSwitchStyleDefault

  • Size: JTMaterialSwitchSize

  • JTMaterialSwitchSizeBig

  • JTMaterialSwitchSizeNormal

  • JTMaterialSwitchSizeSmall

Screen shot

Properties

#pragma State
/** A Boolean value that represents switch's current state(ON/OFF). YES to ON, NO to OFF the switch */
@property (nonatomic) BOOL isOn;
/** A Boolean value that represents switch's interaction mode. YES to set enabled, No to set disabled*/
@property (nonatomic) BOOL isEnabled;
/** A Boolean value whether the bounce animation effect is enabled when state change movement */
@property (nonatomic) BOOL isBounceEnabled;
/** A Boolean value whether the ripple animation effect is enabled or not */
@property (nonatomic) BOOL isRippleEnabled;

#pragma Color
/** An UIColor property to represent the color of the switch thumb when position is ON */
@property (nonatomic, strong) UIColor *thumbOnTintColor;
/** An UIColor property to represent the color of the switch thumb when position is OFF */
@property (nonatomic, strong) UIColor *thumbOffTintColor;
/** An UIColor property to represent the color of the track when position is ON */
@property (nonatomic, strong) UIColor *trackOnTintColor;
/** An UIColor property to represent the color of the track when position is OFF */
@property (nonatomic, strong) UIColor *trackOffTintColor;
/** An UIColor property to represent the color of the switch thumb when position is DISABLED */
@property (nonatomic, strong) UIColor *thumbDisabledTintColor;
/** An UIColor property to represent the color of the track when position is DISABLED */
@property (nonatomic, strong) UIColor *trackDisabledTintColor;
/** An UIColor property to represent the fill color of the ripple only when ripple effect is enabled */
@property (nonatomic, strong) UIColor *rippleFillColor;

Screen shot

Change History

1.1 Bug Fix

1.0.0 Initial Release

Requirements

iOS 7.0 or later

Author

Junichi Tsurukawa j.tsurukawa@gmail.com

License

JTMaterialSwitch is available under the MIT license.

About

A Customizable Switch UI for iOS, Inspired from Google's Material Design

Resources

License

Stars

Watchers

Forks

Packages

No packages published