Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JunichiT/JTMaterialSwitch
A Customizable Switch UI for iOS, Inspired from Google's Material Design
https://github.com/JunichiT/JTMaterialSwitch
Last synced: about 1 month ago
JSON representation
A Customizable Switch UI for iOS, Inspired from Google's Material Design
- Host: GitHub
- URL: https://github.com/JunichiT/JTMaterialSwitch
- Owner: JunichiT
- License: mit
- Created: 2015-09-15T10:19:28.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2015-12-07T09:07:32.000Z (almost 9 years ago)
- Last Synced: 2024-04-24T18:57:38.606Z (5 months ago)
- Language: Objective-C
- Homepage:
- Size: 8.27 MB
- Stars: 319
- Watchers: 10
- Forks: 46
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - JTMaterialSwitch - A customizable switch UI with ripple effect and bounce animations, inspired from Google's Material Design. (UI / Switch)
- awesome-ios-star - JTMaterialSwitch - A customizable switch UI with ripple effect and bounce animations, inspired from Google's Material Design. (UI / Switch)
README
[](https://travis-ci.org/JunichiT/JTMaterialSwitch)
[](http://cocoapods.org/pods/JTMaterialSwitch)
[](http://cocoapods.org/pods/JTMaterialSwitch)
[](http://cocoapods.org/pods/JTMaterialSwitch)
## 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:
```ruby
pod "JTMaterialSwitch"
```
## Usage
The simplest setup:
```objective-c
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.
```objective-c
/**
* 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
#### Properties
```objective-c
#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;
```
## Change History
1.1 Bug Fix
1.0.0 Initial Release
## Requirements
iOS 7.0 or later
## Author
Junichi Tsurukawa
## License
JTMaterialSwitch is available under the MIT license.