Topics

#cocoapods #font #font-awesome #font-icons #icons #ios #swift #swift-3 #swift-library #xcode

Language breakdown

Swift 98.7%

Ruby 0.8%

Objective-C 0.6%

▸ Files click to expand

README

Font Awesome Swift

Follow me: @vaberer

I like ★. Do not forget to ★ this super convenient library.

Added

&

support!

Font Awesome swift library for iOS. No image icons any more. Using Font Awesome Swift library is very easy to use. Look at the demo app which shows all icons and their names or just visit FontAwesome.

Requirements

iOS 8.0+
Xcode 8

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects.

CocoaPods 0.36 adds supports for Swift and embedded frameworks. You can install it with the following command:

$ gem install cocoapods

To integrate Font Awesome Swift into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git' platform :ios, '8.0' use_frameworks!

pod 'Font-Awesome-Swift', '~> 1.7.2'

Then, run the following command:

$ pod install

Do not forget to import to your swift files where you want to use this library:

import FontAwesomeSwift

Check branches swift-2.2, swift-2.3 or swift-3

Manually

Copy FAIcon.swift and FontAwesome.ttf files into your project
Check to import FontAwesome.ttf in project, "Project" > "Target" > "Copy Bundle Resources"

Usage

Super easy way how to add an icon.

UIImage

For Stacked images, please refer Stacked Icons

UIImage.init(icon: .FATwitter, size: CGSize(width: 35, height: 35)) // Change colors UIImage.init(icon: .FATwitter, size: CGSize(width: 35, height: 35), textColor: .red, backgroundColor: .black) // Stacked Images With Bigger Background UIImage.init(bgIcon: .FASquareO, bgTextColor: .white, topIcon: .FATwitter, topTextColor: .white, bgLarge: true) UIImage.init(bgIcon: .FACircle, bgTextColor: .black, topIcon: .FAFlag, topTextColor: .white, bgLarge: true) // Stacked Images With Smaller Background UIImage.init(bgIcon: .FACamera, bgTextColor: .black, topIcon: .FABan, topTextColor: .red, bgLarge: false)

// Stacked Images With Bigger Background and Custom Size UIImage.init(bgIcon: .FASquare, bgTextColor: .black, topIcon: .FATerminal, topTextColor: .white, bgLarge: true, size: CGSize(width: 50, height: 50))

UIImageView

imageView.setFAIconWithName(icon: .FATwitter, textColor: .blue, backgroundColor: .gray)
imageView.setFAIconWithName(icon: .FATwitter, textColor: .blue)

UILabel

labelName.FAIcon = .FAGithub
labelName.setFAIcon(icon: .FAGithub, iconSize: 35)
labelName.setFAText(prefixText: "follow me on ", icon: .FATwitter, postfixText: ". Thanks!", size: 25)
// Bigger icon:     labelName.setFAText(prefixText: "follow me on  ", icon: .FATwitter, postfixText: ". Thanks!", size: 25, iconSize: 30)
labelName.setFAColor(.red)

UIButton

buttonName.setFAIcon(icon: .FAGithub, forState: .normal) // Set icon size buttonName.setFAIcon(icon: .FAGithub, iconSize: 35, forState: .normal) buttonName.setFAText(prefixText: "follow me on ", icon: .FATwitter, postfixText: ". Thanks!", size: 25, forState: .normal) // Bigger icon buttonName.setFAText(prefixText: "follow me on ", icon: .FATwitter, postfixText: ". Thanks!", size: 25, forState: .normal, iconSize: 30)

// Change color: buttonName.setFATitleColor(color: .red, forState: .normal))

UIBarButtonItem

// Standard font size barName.FAIcon = .FAGithub // Custom font size barName.setFAIcon(icon: .FAGithub, iconSize: 35) barName.setFAText(prefixText: "follow me on ", icon: .FATwitter, postfixText: ". Thanks!", size: 25)

barName.tintColor = .red

UITextField

// Right View Icon textfield.setRightViewFAIcon(icon: .FASearch, rightViewMode: .always, textColor: .red, backgroundColor: .clear, size: nil)

// Left View Icon textfield.setLeftViewFAIcon(icon: .FAPlus, leftViewMode: .always, textColor: .red, backgroundColor: .clear, size: nil)

UISegmentedControl

segmentedControl.setFAIcon(icon: .FATwitter, forSegmentAtIndex: 0)

UIStepper

stepper.setFABackgroundImage(icon: .FAGithub, forState: .normal)
    stepper.setFAIncrementImage(icon: .FABellO, forState: .normal)
    stepper.setFADecrementImage(icon: .FABellSlashO, forState: .normal)

UITabbarItem

tabBarController?.tabBar.items?.first?.setFAIcon(.FATwitter)
  
  // Options to change selected and unselected color
  tabBarItem.setFAIcon(icon: .FATwitter, size: nil, textColor: .red, backgroundColor: .black, selectedTextColor: .yellow, selectedBackgroundColor: .white)
  
  // Options to change selected and unselected color with specific size
  tabBarItem.setFAIcon(icon: .FATwitter, size: CGSize(width: 35, height: 35), textColor: .red, backgroundColor: .black, selectedTextColor: .yellow, selectedBackgroundColor: .white)

UISlider

// Change minimum or maximum value image
  slider.setFAMinimumValueImage(icon: .FABellSlashO)
  slider.setFAMaximumValueImage(icon: .FABellO)
// change minimum or maximum value image with a specific size   slider.setFAMinimumValueImage(icon: .FABellSlashO, customSize:  CGSize(width: 35, height: 35))   slider.setFAMaximumValueImage(icon: .FABellO, customSize:  CGSize(width: 35, height: 35))

UIViewController

// Change navigation title
  FATitle = .FATwitter

Author

Patrik Vaberer, patrik@toptal.com

Licence

Font Awesome Swift is available under the MIT license. See the LICENSE file for more info.

🔗 More in this category