theakay / swifticonfont

Icons fonts for iOS (FontAwesome, Iconic, Ionicon, Octicon, Themify, MapIcon, MaterialIcon)

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, [email protected]

License

SwiftIconFont is available under the MIT license. See the LICENSE file for more info.

Contributing

1. Fork it (http://github.com/0x73/SwiftIconFont/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request