Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thinkclay/FlourishUI
A highly configurable and out-of-the-box-pretty UI library
https://github.com/thinkclay/FlourishUI
Last synced: about 1 month ago
JSON representation
A highly configurable and out-of-the-box-pretty UI library
- Host: GitHub
- URL: https://github.com/thinkclay/FlourishUI
- Owner: thinkclay
- License: mit
- Created: 2015-02-26T23:49:20.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2019-05-01T01:02:13.000Z (over 5 years ago)
- Last Synced: 2024-08-10T02:01:53.136Z (5 months ago)
- Language: Swift
- Size: 12.5 MB
- Stars: 227
- Watchers: 12
- Forks: 18
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ui - FlourishUI - Provides you with modals and other customizable controls. (Swift / Others)
- awesome-ios-star - FlourishUI - A highly configurable and out-of-the-box-pretty UI library. (UI / Font)
- awesome-ios - FlourishUI - A highly configurable and out-of-the-box-pretty UI library. (UI / Font)
README
# FlourishUI
[](https://travis-ci.org/Clay McIlrath/FlourishUI)
[](http://cocoapods.org/pods/FlourishUI)
[](http://cocoapods.org/pods/FlourishUI)
[](http://cocoapods.org/pods/FlourishUI)
We absolutely **love** beautiful interfaces! As an organization named Unicorn, we are obligated to be unique and majestic. That is why we have made this highly configurable, out-of-the-box-pretty, User Interface library/kit thingy. It has a minimal set of UI components now, but already packs quite a punch with the UIColor extension, animated Material-inspired buttons, and modal views.
## Getting Started
To run the example project, clone the repo, and run `pod install` from the Example directory first.
***Release Notes***
[Master](https://github.com/unicorn/FlourishUI/tree/master) contains the latest bleeding edge code. Currently master is supporting Swift 3.0 but there are [releases](https://github.com/thinkclay/FlourishUI/releases) for older versions of Swift.
This library was built on iOS 8.x, but does offer decent backwards compatibility. We haven't tested older devices thoroughly however, so if you find a breaking issue, please file an issue on the repo or submit a pull request!
### Inspiration
This library was hand-written, but borrowed from concepts in [ZFRipple](https://github.com/zoonooz/ZFRippleButton),
[SLCAlertView](https://github.com/vikmeup/SCLAlertView-Swift) and [Material](http://www.google.com/design/spec/material-design/introduction.html). We'd like to thank them for paving the way for some cool concepts and for contributing their code as MIT. Following suit, we have also made this open source and completely void of copyright or restrictions. Just use it already, and make your apps look like sexy unicorns!
## Installation
FlourishUI is available through [CocoaPods](http://cocoapods.org). To install it, simply add the following line to your Podfile:
```ruby
pod "FlourishUI"
```
Or if you prefer to skip cocoapods, you can simply drag and drop the [source files](https://github.com/thinkclay/FlourishUI/tree/master/Pod/Classes) directly into your Xcode project.
## Usage
Most of the code should be pretty self documenting. FlourishUI uses structs and enums heavily to make an easy-to-read and highly meta approach. Future updates will probably keep the API mostly the same, but switch to a better underlying infrastructure of getters and setters.
### Button
The Button class is ready to go with Interface Builder and IBDesignable, just inherit! You can check the demo to see this configured with IB.
### Modal
Modals are heavily based on configurations, and thus, are built and called in code. We plan on making them more robust in time, but for now, you'll want to simply treat them like you would an AlertView.
```swift
Modal.Overlay.blurStyle = .ExtraLight
Modal.Dialog.shadowType = .Hover
Modal.Dialog.shadowRadius = CGFloat(5)
Modal.Dialog.shadowOffset = CGSize(width: 0, height: 0)
Modal.Dialog.shadowOpacity = 0.1
Modal(title: sender.titleLabel?.text, body: body, status: .Warning).show()
```
### Toggle Switch
Flourish UI supports Toggle Switches as of 3.x and up! These are drawn entirely with core graphics and animated with UIKit, giving you vector scale and full customization.
```swift
//
// Customizing toggle switches
//
let greenColor = UIColor(hex: "#3D8C8E")
let toggle2 = ToggleSwitch()
toggle2.frame = CGRect(x: 20, y: view.frame.height - 100, width: view.frame.width - 40, height: 24)
toggle2.label.setTitle("Custom styled toggle", for: .normal)
toggle2.active = true
// Customize the label associated with the toggle switch
toggle2.label.frame.size.width = 200
toggle2.label.titleLabel?.textColor = .black
// Customize the background which the toggle button slides across
toggle2.slide.activeBackgroundColor = greenColor.adjustValue(percentage: 1.4)
toggle2.slide.activeBorderColor = greenColor.adjustValue(percentage: 1.0)
toggle2.slide.disabledBackgroundColor = UIColor(hex: "#99896F")
toggle2.slide.disabledBorderColor = UIColor(hex: "#99896F").adjustValue(percentage: 0.5)
// Customize the round toggle button
toggle2.button.activeBackgroundColor = greenColor.adjustValue(percentage: 1.3)
toggle2.button.activeBorderColor = greenColor.adjustValue(percentage: 1.1)
toggle2.button.disabledBackgroundColor = UIColor(rgba: [153, 137, 111, 0.8])
toggle2.button.disabledBorderColor = UIColor(rgba: [153, 137, 111, 0.8]).adjustValue(percentage: 0.5)
view.addSubview(toggle2)
```
### UIColor Extension
```swift
// Create colors with hex value in string
let red = UIColor(hex: "#ff0000")
// Darken or lighten the value (lightness)
// 1 = 100% therefore > 1 is lighter and < 1 is darker
red.adjustValue(percentage: 1.5)
```
## License
FlourishUI is available under the MIT license. See the LICENSE file for more info.