Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Grouper/FlatUIKit

A collection of awesome flat UI components for iOS.
https://github.com/Grouper/FlatUIKit

Last synced: 8 days ago
JSON representation

A collection of awesome flat UI components for iOS.

Awesome Lists containing this project

README 

        
Background

======

FlatUIKit was originally written by Jack Flintermann in March of 2013, before iOS7 had even come out.  The idea was to give a nice flat look to some of the native iOS components.  Then iOS7 came along and introduced a decent API to do most of these tasks.  



However, for backwards compatability, we will be attempting to maintain iOS6 compatability, as long as feasabilty possible.  If we find a reason to move to iOS7 only support, we will leave a branch for remaining iOS6 support, and move forward.



FlatUIKit

======



FlatUIKit is a collection of iOS components styled with the "Flat UI" aesthetic that we created while building [Grouper for iPhone](http://www.joingrouper.com). Its design inspiration comes from [Flat UI](http://designmodo.github.io/Flat-UI/) and [Kyle Miller](http://kylemillercreative.com/grouper-social-club). Styling is implemented via categories on/drop-in replacements for existing UIKit components, so integrating it into your project is very straightforward.



Installation

-------



FlatUIKit can be installed via [CocoaPods](http://cocoapods.org/). Simply add



```ruby

pod 'FlatUIKit'

```



to your Podfile. If you don't use CocoaPods you're welcome to use git submodules, or simply [download it](https://github.com/Grouper/FlatUIKit/archive/master.zip) and include it in your project manually.



Note that FlatUIKit requires the CoreText framework as well as iOS > 6.0.



The Components

-------



### Buttons



FUIButton is a drop-in subclass of UIButton that exposes the additional properties buttonColor, shadowColor, cornerRadius, and shadowHeight. Note that if you set any of these, you have to set all of them.



```objective-c

myButton.buttonColor = [UIColor turquoiseColor];

myButton.shadowColor = [UIColor greenSeaColor];

myButton.shadowHeight = 3.0f;

myButton.cornerRadius = 6.0f;

myButton.titleLabel.font = [UIFont boldFlatFontOfSize:16];

[myButton setTitleColor:[UIColor cloudsColor] forState:UIControlStateNormal];

[myButton setTitleColor:[UIColor cloudsColor] forState:UIControlStateHighlighted];

```



![FUIButton](https://raw.github.com/Grouper/FlatUIKit/master/Example/README%20images/fuibutton-small.gif)



### TextFields



FUITextField is a drop-in subclass of UITextField that exposes the additional properties edgeInsets, textFieldColor, borderColor, borderWidth and cornerRadius. Note that if you set any of these, you have to set all of them.



```objective-c

myTextField.font = [UIFont flatFontOfSize:16];

myTextField.backgroundColor = [UIColor clearColor];

myTextField.edgeInsets = UIEdgeInsetsMake(4.0f, 15.0f, 4.0f, 15.0f);

myTextField.textFieldColor = [UIColor whiteColor];

myTextField.borderColor = [UIColor turquoiseColor];

myTextField.borderWidth = 2.0f;

myTextField.cornerRadius = 3.0f;

```



![FUITextField](Example/README%20images/fuitextfield-small.gif)



### SegmentedControls



FUISegmentedControl is a drop-in subclass of UISegmentedControl that exposes the additional properties selectedColor, deselectedColor, selectedFont, deselectedFont, selectedFontColor, deselectedFontColor, dividerColor and cornerRadius. Note that if you set any of these, it is recommended that you set all of them.



```objective-c

mySegmentedControl.selectedFont = [UIFont boldFlatFontOfSize:16];

mySegmentedControl.selectedFontColor = [UIColor cloudsColor];

mySegmentedControl.deselectedFont = [UIFont flatFontOfSize:16];

mySegmentedControl.deselectedFontColor = [UIColor cloudsColor];

mySegmentedControl.selectedColor = [UIColor amethystColor];

mySegmentedControl.deselectedColor = [UIColor silverColor];

mySegmentedControl.dividerColor = [UIColor midnightBlueColor];

mySegmentedControl.cornerRadius = 5.0;

```



### Switches



FUISwitch is not a subclass of UISwitch (UISwitch is too inflexible to subclass), but rather a reimplementation that exposes all of the methods of UISwitch. In addition, it also provides access to its underlying on/off UILabels and other subviews.



```objective-c

mySwitch.onColor = [UIColor turquoiseColor];

mySwitch.offColor = [UIColor cloudsColor];

mySwitch.onBackgroundColor = [UIColor midnightBlueColor];

mySwitch.offBackgroundColor = [UIColor silverColor];

mySwitch.offLabel.font = [UIFont boldFlatFontOfSize:14];

mySwitch.onLabel.font = [UIFont boldFlatFontOfSize:14];

```



![FUISwitch](https://raw.github.com/Grouper/FlatUIKit/master/Example/README%20images/fuiswitch-small.gif)



### Alert Views



Similar to FUISwitch, FUIAlertView is a reimplemenation of UIAlertView that exposes all of UIAlertView's methods (and delegate methods, with the FUIAlertViewDelegate protocol), but with far greater flexibility in UI customization. All of its child UILabels, UIViews, and FUIButtons can be customized at will.



```objective-c

FUIAlertView *alertView = [[FUIAlertView alloc] initWithTitle:@"Hello"

                                                      message:@"This is an alert view"

                                                     delegate:nil cancelButtonTitle:@"Dismiss"

                                            otherButtonTitles:@"Do Something", nil];

alertView.titleLabel.textColor = [UIColor cloudsColor];

alertView.titleLabel.font = [UIFont boldFlatFontOfSize:16];

alertView.messageLabel.textColor = [UIColor cloudsColor];

alertView.messageLabel.font = [UIFont flatFontOfSize:14];

alertView.backgroundOverlay.backgroundColor = [[UIColor cloudsColor] colorWithAlphaComponent:0.8];

alertView.alertContainer.backgroundColor = [UIColor midnightBlueColor];

alertView.defaultButtonColor = [UIColor cloudsColor];

alertView.defaultButtonShadowColor = [UIColor asbestosColor];

alertView.defaultButtonFont = [UIFont boldFlatFontOfSize:16];

alertView.defaultButtonTitleColor = [UIColor asbestosColor];

[alertView show];

```

    

NOTE: to create FUIAlertView instance in Swift please use default initializer

s

```swift

let alertView = FUIAlertView()

```

FUIAlertView



### Sliders/Steppers/Progress Views

To provide flat UISliders, UIProgressViews and UISteppers, we simply provide categories on UISlider/ProgressView/UIStepper to automatically configure their appearance with appropriate colors/corner radii. This makes for zero-friction integration with your existing project:



```objective-c

[mySlider configureFlatSliderWithTrackColor:[UIColor silverColor]

                              progressColor:[UIColor alizarinColor]

                                 thumbColor:[UIColor pomegranateColor]];

```



![FUISlider](https://raw.github.com/Grouper/FlatUIKit/master/Example/README%20images/fuislider-small.gif)



```objective-c

[myProgressView configureFlatProgressViewWithTrackColor:[UIColor silverColor]

                              progressColor:[UIColor alizarinColor]];



[myStepper configureFlatStepperWithColor:[UIColor wisteriaColor]

                        highlightedColor:[UIColor wisteriaColor]

                           disabledColor:[UIColor amethystColor]

                               iconColor:[UIColor cloudsColor]];

```



![FUIStepper](https://raw.github.com/Grouper/FlatUIKit/master/Example/README%20images/fuistepper-small.gif)



### Bar Button Items

To customize bar button items for your entire application (including back buttons), UIBarButtonItem+FlatUI provides a class method which leverages the UIBarButtonItem appearance proxy to do this in one step:



```objective-c

[UIBarButtonItem configureFlatButtonsWithColor:[UIColor peterRiverColor]

                              highlightedColor:[UIColor belizeHoleColor]

                                  cornerRadius:3];

```



![FUINavBar](https://raw.github.com/Grouper/FlatUIKit/master/Example/README%20images/fuinavbar-small.gif)



However, this might cause rendering issues with controllers that are pushed from actionsheets, sharesheets or links in webviews. To prevent this behavior, scope the customized bar buttom items to your controllers:



```objective-c

[UIBarButtonItem configureFlatButtonsWithColor:[UIColor peterRiverColor]

                              highlightedColor:[UIColor belizeHoleColor]

                                  cornerRadius:3

                               whenContainedIn:[YourViewController class]];

```



### Navigation Bars

As above, we provide a category on UINavigationBar to configure it flatly with a single color:



```objective-c

[self.navigationController.navigationBar configureFlatNavigationBarWithColor:[UIColor midnightBlueColor]];

```



### TableView Cells

You can modify the backgroundColor and selectedBackgroundColor of a UITableViewCell without losing the rounded corners. The cell will copy the UITableView's separator color. The separator height is exposed as separatorHeight and the radius as cornerRadius.



```objective-c

UITableViewCell *cell = ...;

[cell configureFlatCellWithColor:[UIColor greenSeaColor]

                   selectedColor:[UIColor cloudsColor]

                 roundingCorners:corners];



cell.cornerRadius = 5.0f; // optional

cell.separatorHeight = 2.0f; // optional

```



![FUITableViewCell](https://raw.github.com/Grouper/FlatUIKit/master/Example/README%20images/fuitableview-small.png)



### Popover

Like some other flat components, we simply provide a category to automatically configure a popover appearance for iPad by only having to set a background color.



```objective-c

popover = [[UIPopoverController alloc] initWithContentViewController:nc];

[popover configureFlatPopoverWithBackgroundColor: [UIColor midnightBlueColor] cornerRadius:3];

popover.delegate = self;

[popover presentPopoverFromRect:button.frame inView:self.view permittedArrowDirections:UIPopoverArrowDirectionAny animated:YES];

```



![Popover](https://raw.github.com/Grouper/FlatUIKit/master/Example/README%20images/fuipopovercontroller-small.gif)



Colors

-------



For convenience, FlatUIKit includes the colors defined at [Flat UI Colors](http://flatuicolors.com/). You can see examples of these colors in the code/components above. Using them is as simple as:



```objective-c

#import 

UIColor *myColor = [UIColor turquoiseColor];

```



Fonts

-------



FlatUIKit comes bundled with Lato, a clean, beautiful open font. More info on Lato can be found [here](http://www.latofonts.com/). It is included in FlatUIKit automatically; you can use it as follows:



```objective-c

#import "UIFont+FlatUI.h"

UIFont *myFont = [UIFont flatFontOfSize:16];

```



Icons

-------



You can now use the great icons provided by [FlatUIKit](http://designmodo.github.io/Flat-UI/) in your app.  The easiest way is to use a label, but I will be adding support to use them in buttons, ImageViews, and other conveniences.  



```objective-c

#import "NSString+Icons.h"

UILabel *label = [...]

label.font = [UIFont iconFontWithSize:16];

label.text = [NSString iconStringForEnum:FUIHeart];

```



The icons follow roughly the same naming scheme as FlatUI, but you can look up the enumeration in NSString+Icons.h



Contributions

--------



Contributions are totally welcome. We'll review all pull requests and if you send us a good one/are interested we're happy to give you push access to the repo.