Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spromicky/StepSlider
StepSlider its custom implementation of slider such as UISlider for preset integer values.
https://github.com/spromicky/StepSlider
carthage cocoapods coreanimation enum haptic ios labels preset-values slider stepslider uikit uislider xcode
Last synced: 25 days ago
JSON representation
StepSlider its custom implementation of slider such as UISlider for preset integer values.
- Host: GitHub
- URL: https://github.com/spromicky/StepSlider
- Owner: spromicky
- License: mit
- Created: 2015-10-20T15:37:03.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2021-06-15T10:27:43.000Z (about 3 years ago)
- Last Synced: 2024-04-24T18:57:32.751Z (5 months ago)
- Topics: carthage, cocoapods, coreanimation, enum, haptic, ios, labels, preset-values, slider, stepslider, uikit, uislider, xcode
- Language: Objective-C
- Homepage:
- Size: 287 KB
- Stars: 555
- Watchers: 12
- Forks: 109
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - StepSlider - StepSlider its custom implementation of slider such as UISlider for preset integer values. (UI / Slider)
- awesome-cocoa - StepSlider
- awesome-ios-star - StepSlider - StepSlider its custom implementation of slider such as UISlider for preset integer values. (UI / Slider)
README
# StepSlider
StepSlider its custom implementation of slider such as `UISlider` for preset values. Behind the scenes StepSlider manipulate integer indexes. Its based on drawing directlyon `CAShapeLayer`.
## Usage
You can add StepSlider right from code with any of standard initialisers. Or you can add it directly on your storybord. Its fully `IBDesignable` and `IBInspetable` compatible.
```objc
StepSlider *slider = [[StepSlider alloc] initWithFrame:CGRectMake(10.f, 200.f, 300.f, 44.f)];
[slider setMaxCount:10];
[slider setIndex:2];
[self.view addSubview:slider];
```
StepSlider can be fully customised by any of this properties:
- `trackHeight`
- `trackCircleRadius`
- `sliderCircleRadius`
- `dotsInteractionEnabled`
- `trackColor`
- `sliderCircleColor`
- `sliderCircleImage`
Supports haptic feedback on `valueChanged:`.
#### Labels
From version `1.0.0` StepSlider support labels near each circle on track.
```objc
slider.labels = @[@"Some string", @"another string", @"one more"];
```
`slider.adjustLabel` - set first and last label to exactly to frame left and right.
From version `1.8.0` StepSlider support `NSAttributedString` as label text.
#### Images
For `1.2.0` and higher you can use images for `sliderCircle ` and `trackCircles`. For `trackCircles` supported two states: `normal` and `selected`.
```objc
[self.sliderView setTrackCircleImage:[UIImage imageNamed:@"unselected_dot"] forState:UIControlStateNormal];
[self.sliderView setTrackCircleImage:[UIImage imageNamed:@"selected_dot"] forState:UIControlStateSelected];
```
## Requirements
- version `1.3.0` and above needs iOS 10.0+
- version `1.2.1` supports iOS 7.0+
## Installation
### CocoaPods
To integrate `StepSlider` into your Xcode project using CocoaPods, specify it in your `Podfile`:
```
pod 'StepSlider', '~> 1.8.0'
```
Then, run the following command:
```
$ pod install
```
### Carthage
To integrate `StepSlider` into your Xcode project using Carthage, specify it in your `Cartfile`:
```
github "spromicky/StepSlider" ~> 1.8.0
```
Run `carthage update` to build the framework and drag the built `StepSlider.framework` into your Xcode project.
### Swift Package Manager
Start `1.8.0` StepSlider can be integrated in your Xcode project. When adding new package search `StepSlider` and select version `1.8.0` or above.
### Manual Installation
Just copy `StepSlider` class to your project.
## License
StepSlider is available under the MIT license. See the LICENSE file for more info.