Installation
Carthage
Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.
You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage
To integrate SwiftIconFont into your Xcode project using Carthage, specify it in your Cartfile
:
github "0x73/SwiftIconFont"
Cocoapods
CocoaPods is a dependency manager for Cocoa projects.
You can install it with the following command:
$ gem install cocoapods
To integrate SwiftIconFont into your Xcode project using CocoaPods, specify it in your Podfile
:
use_frameworks!
pod 'SwiftIconFont'
Example
To run the example project, clone the repo, and run pod install
from the Example directory first.
Prefixes
Font | Prefix | Cheat Sheet |
---|---|---|
Font Awesome | fa: | List |
Ion Icons | io: | List |
Octicons | oc: | List |
Open Iconic | ic: | List |
Material Icon | ma: | List |
Themify | ti: | List |
Map Icons | mi: | List |
Fonts
public enum Fonts {
case FontAwesome
case Iconic
case Ionicon
case Octicon
case Themify
case MapIcon
case MaterialIcon
}
Runtime Structure
###< Prefix >:< Icon >
##Usage
In your UILabel, UIButton or UITextField, set a text containing a placeholder anywhere you want the icon to be. Somethink like this
oc:logo-github
Then you can choose between 3 ways you can use SwiftIconFont.
####1. No Custom Class
Simply import SwiftIconFont and call processIcons on any UILabel, UIButton or UITextField that has a placeholder.
label.parseIcon()
####2. Custom Class
The lazy way, just set your UILabel, UITextField, UIButton, UITextView, UIBarButtonItem class as SwiftIconLabel, SwiftIconTextField, SwiftIconButton, SwiftIconTextView, SwiftBarButtonItem, and thats it, your icons will be processed at runtime.
####3. Programmatically
import SwiftIconFont
label.font = UIFont.iconFontOfSize(.FontAwesome, fontSize: 50.0)
label.text = String.fontAwesomeIconWithCode("twitter")
####UIBarButtonItem (No Custom Class)
import SwiftIconFont
twitterBarButton.setFontIcon(Fonts.FontAwesome, icon: "twitter", fontSize: 20)
####UITabBarItem (No Custom Class)
import SwiftIconFont
twitterTabBarButton.setFontIcon(Fonts.FontAwesome, iconCode: "twitter", imageSize: CGSizeMake(20, 20), fontSize: 20)
Author
Sedat Gokbek CIFTCI, me@sedat.ninja
License
SwiftIconFont is available under the MIT license. See the LICENSE file for more info.
Contributing
- Fork it (http://github.com/0x73/SwiftIconFont/fork)
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request