Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Ramotion/fluid-slider
:octocat:💧 A slider widget with a popup bubble displaying the precise value selected. Swift UI library made by @Ramotion
https://github.com/Ramotion/fluid-slider
ios library swift
Last synced: 3 months ago
JSON representation
:octocat:💧 A slider widget with a popup bubble displaying the precise value selected. Swift UI library made by @Ramotion
- Host: GitHub
- URL: https://github.com/Ramotion/fluid-slider
- Owner: Ramotion
- License: mit
- Created: 2017-10-20T11:46:58.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-06-01T06:20:38.000Z (over 2 years ago)
- Last Synced: 2024-07-19T06:03:05.166Z (4 months ago)
- Topics: ios, library, swift
- Language: Swift
- Homepage: https://www.ramotion.com/fluid-slider/
- Size: 9.48 MB
- Stars: 1,969
- Watchers: 43
- Forks: 151
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - Fluid Slider - A slider widget with a popup bubble displaying the precise value selected. (UI / Slider)
- awesome-swift - Fluid Slider - A slider widget with a popup bubble displaying the precise value selected. (Libs / UI)
- awesome-cocoa - fluid-slider
- awesome-swift - Fluid Slider - A slider widget with a popup bubble displaying the precise value selected. (Libs / UI)
- awesome-ios-star - Fluid Slider - A slider widget with a popup bubble displaying the precise value selected. (UI / Slider)
- awesome-neuron - fluid-slider
- fucking-awesome-swift - Fluid Slider - A slider widget with a popup bubble displaying the precise value selected. (Libs / UI)
- awesome-ios - Fluid Slider - A slider widget with a popup bubble displaying the precise value selected. Swift UI library. [•](https://raw.githubusercontent.com/Ramotion/fluid-slider/master/fluid-slider.gif) (Content / Slider)
- awesome-swift - Fluid Slider - A slider widget with a popup bubble displaying the precise value selected. Swift UI library made by @Ramotion ` 📝 a year ago ` (UI [🔝](#readme))
README
FLUID SLIDER
A slider widget with a popup bubble displaying the precise value selected written on Swift.
___
We specialize in the designing and coding of custom UI for Mobile Apps and Websites.
Stay tuned for the latest updates:
Inspired by [Virgil Pana](https://dribbble.com/virgilpana) [shot](https://dribbble.com/shots/3868232-Fluid-Slider)
[](http://twitter.com/Ramotion)
[](https://github.com/Ramotion/fluid-slider)
[](https://codebeat.co/projects/github-com-ramotion-fluid-slider)
[](https://paypal.me/Ramotion)
## Requirements
- iOS 10.0
- Xcode 9
- Swift 4.0
## Installation
You can install `fluid-slider` in several ways:
- Add source files to your project.
- Use [CocoaPods](https://cocoapods.org):
``` ruby
pod 'fluid-slider'
```
- Use [Carthage](https://github.com/Carthage/Carthage):
```
github "Ramotion/fluid-slider"
```
## Usage
### Slider
```swift
import fluid_slider
```
The slider can be inserted in a view hierarchy as a subview. Appearance can be configured with a number of public attributes:
```swift
let slider = Slider()
slider.attributedTextForFraction = { fraction in
let formatter = NumberFormatter()
formatter.maximumIntegerDigits = 3
formatter.maximumFractionDigits = 0
let string = formatter.string(from: (fraction * 500) as NSNumber) ?? ""
return NSAttributedString(string: string)
}
slider.setMinimumLabelAttributedText(NSAttributedString(string: "0"))
slider.setMaximumLabelAttributedText(NSAttributedString(string: "500"))
slider.fraction = 0.5
slider.shadowOffset = CGSize(width: 0, height: 10)
slider.shadowBlur = 5
slider.shadowColor = UIColor(white: 0, alpha: 0.1)
slider.contentViewColor = UIColor(red: 78/255.0, green: 77/255.0, blue: 224/255.0, alpha: 1)
slider.valueViewColor = .white
view.addSubview(slider)
```
Take a look at the `Example` project for an integration example.
Since `Slider` is a subclass of `UIControl`, it inherits target-action mechanics and it's possible to listen for user-triggered value changes:
```swift
slider.addTarget(self, action: #selector(sliderValueChanged), for: .valueChanged)
```
### Tracking Behavior
There are a couple of callbacks which allow you to listen to the slider's tracking events:
```swift
var didBeginTracking: ((Slider) -> ())?
var didEndTracking: ((Slider) -> ())?
```
## Animation Performance
This control is designed to use device CPU resources with care. The fluid-style animation will be disabled when low power mode is enabled or the system is under heavy load.
This library is a part of a selection of our best UI open-source projects.
## 🗂 Check this library on other language:
## 📄 License
Fluid Slider is released under the MIT license.
See [LICENSE](./LICENSE) for details.
This library is a part of a selection of our best UI open-source projects.
If you use the open-source library in your project, please make sure to credit and backlink to https://www.ramotion.com/
## 📱 Get the Showroom App for iOS to give it a try
Try this UI component and more like this in our iOS app. Contact us if interested.
