FontAwesomeKit.Swift
========
😀😘A better choice for iOS Developer to use FontAwesome Icon with UI.😍     
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/qiuncheng/FontAwesomeKit.Swift/master/LICENSE)
[![](https://img.shields.io/cocoapods/v/FontAwesomeKit.Swift.svg)](https://cocoapods.org/pods/FontAwesomeKit.Swift)
[![](https://img.shields.io/badge/support-iOS8-lightgrey.svg)](https://github.com/qiuncheng/FontAwesomeKit.Swift)
[![](https://img.shields.io/badge/platform-iOS-yellow.svg)](https://github.com/qiuncheng/FontAwesomeKit.Swift)
[![](https://img.shields.io/badge/Swift-4.2-yellowgreen.svg)](https://github.com/qiuncheng/FontAwesomeKit.Swift)

![FontAwesome.otf 4.7.0](https://raw.githubusercontent.com/qiuncheng/FontAwesomeKit.Swift/master/Screenshots/FontAwesomeKitExample.png)

Support
========
Swift 4.2 & iOS 8.0+   
FontAwesome 4.7.0  
Storyboard supported.

Installation
========
#### CocoaPods
1. add `pod 'FontAwesomeKit.Swift'` to your Podfile.
2. Run `pod install` OR `pod update`.
3. `import FontAwesomeKit_Swift`

#### Manually
1. [Download](https://github.com/qiuncheng/FontAwesomeKit.Swift/archive/master.zip) the full file.
2. Drag the FontAwesomeKit folder to your project.

Example
========

#### Use `FontAwesomeKit.Swift` in Storyboard. 
 1. Set Custom class to `FontAwesomeButton` or `FontAwesomeLabel`
 2. Set unicode string in Attributes inspector for `FontAwesomeLabel` or set `normal`, `highlighted`, `selected`, `disabled` unicode string for `FontAwesomeButton`, such as `f107` or `0xf107`  
 // All awesome unicode --> http://fontawesome.io/cheatsheet/


![FontAwesomeKit.Swift For Storyboard](https://raw.githubusercontent.com/qiuncheng/FontAwesomeKit.Swift/master/Screenshots/storyboard.jpg)

#### Use `FontAwesomeKit.Swift` with String.
```
let str1 = String.fontAwesome(undefined: 0xf107)
let str2 = String.fontAwesome(awesomeType: .github)
let attrs = [NSFontAttributeName: UIFont(fontSize: 32)]
let attrStr1 = NSAttributedString(string: str1)
let attrStr2 = NSAttributedString(string: str2)
```
The attrStr1 will get icon. ![](http://7xk67j.com1.z0.glb.clouddn.com/gift.png)
The attrStr2 will get icon.![](http://7xk67j.com1.z0.glb.clouddn.com/github.png)
#### Use `FontAwesomeKit.Swift` with UILabel.
```
let label = UILabel()
label.text = .apple
label.font = UIFont(fontSize: 100)
/// text : FontAwesomeType.
```
#### Use `FontAwesomeKit.Swift` with UIButton.
```
let button = UIButton(type: .custom)
button.setTitle(.gift, for: .normal)
/// type : The fontAwesome type, and you don’t need to ‘setImage’ or ‘setBackgroundImage’
/// state : The state that uses the specified title. The possible values are described in UIControlState.
button.titleLabel?.font = UIFont(fontSize: 50)
```
#### Use `FontAwesomeKit.Swift` with UIImage.
```
let image1 = UIImage(awesomeType: .github)
/// fontSize : The fontSize you can give, default is 80.
/// tintColor : The UIImage filled color you get, default is UIColor.lightGray.
let image2 = UIImage(awesomeType: .github, size: 30.0, color: UIColor.black)
```
#### Use `FontAwesomeKit.Swift` with UINavigationBarItem.
```
let rightItem = UIBarButtonItem(awesomeType: .github, style: .plain, target: nil, action: nil)
let leftItem = UIBarButtonItem(awesomeType: .github, size: 24, style: .plain, target: nil, action: nil)
/// fontSize : The font size, default is ‘24.0’
/// awesomeType : FontAwsomeType
```

LICENCE
========
Under [MIT License](https://github.com/qiuncheng/FontAwesomeKit.Swift/blob/master/LICENSE)

Thanks
========
1. [The FontAwesome Unicode list.](http://fontawesome.io/cheatsheet/) From fontawesome.io
2. [The Lastest(version4.7.0) FontAwesome.otf bundle](http://fontawesome.io/assets/font-awesome-4.7.0.zip)