muyuto/hexcolors

HexColors is an extension for UIColor and NSColor to support for creating colors from a hex strings

========================= [](https://github.com/mrs-/HexColors) [](https://developer.apple.com/xcode) [](https://swift.org)   [](https://travis-ci.org/mrs-/HexColors) [](https://codecov.io/gh/mRs-/HexColors)

HexColors is an extension for UIColor and NSColor to support for creating colors from a hex string like #FF0088 or 8844FF and back to a String. Completely rewritten in Swift 3!

If you want to use this in Objective-C jump to the 4.X version tag.

#RELEASE 5.0.1 Copy paste Typo Fixxed.

#Examples How to use HexColors in the different systems.

##iOS / watchOS / tvOS

Generating UIColors

let colorWithHex = UIColor("#ff8942")
let colorWithoutHex = UIColor("ff8942")
let colorWithHexAndAlhpa = UIColor("#ff8942DF")
let colorWithoutHexAndAlhpa = UIColor("ff8942DF")
let shortColorWithHex = UIColor("#fff")
let shortColorWithoutHex = UIColor("fff")
let shortColorWithHexAndAlpha = UIColor("#FFFD")
let shortColorWithoutHexAndAlpha = UIColor("#FFFD")

Generating Hex Strings from UIColor

let colorWithHex = UIColor("#ff8942")
let stringFromColor = colorWithHex.hex

##macOS

Generating NSColor

let colorWithHex = NSColor("#ff8942")
let colorWithoutHex = NSColor("ff8942")
let colorWithHexAndAlhpa = NSColor("#ff8942DF")
let colorWithoutHexAndAlhpa = NSColor("ff8942DF")
let shortColorWithHex = NSColor("#fff")
let shortColorWithoutHex = NSColor("fff")
let shortColorWithHexAndAlpha = NSColor("#FFFD")
let shortColorWithoutHexAndAlpha = NSColor("#FFFD")

Generating Hex Strings from NSColor

let colorWithHex = NSColor("#ff8942")
let stringFromColor = colorWithHex.hex

#Installation

##Requirements HexColors requires >= iOS 8.0 and >=macOS 10.9.

Cocoapods

Add HexColors to your Podfile:

pod 'HexColors'

• pod install HexColors

Carthage

Add HexColors to your Cartfile:

github "mRs-/HexColors"

Swift Package Manager

To work with the Swift Package Manager you need to add a Package.swift file and defining your package.

import PackageDescription

let package = Package(
    name: "YourPackageName",
    dependencies: [
        .Package(url: "https://github.com/mRs-/HexColors", majorVersion: 5),
    ]
)

Then execute the Swift Package Manager with the following Shell commands:

swift build
.build/debug/YourPackageName

Manual

Simply just drag and drop the HexColors.swift in your project.

#Credits HexColors was created by Marius Landwehr because of the pain to create Colors from a API (mostly hex) converting to a UI/NSColor.

#Creator Marius Landwehr @mariusLAN

#License HexColors is available under the MIT license. See the LICENSE file for more info.