Skip to content

Latest commit

 

History

History
112 lines (84 loc) · 2.88 KB

README.md

File metadata and controls

112 lines (84 loc) · 2.88 KB
Raw

Rainbow

Color conversion and manipulation library for Swift, with no rely on UIKit/AppKit.

Highlights

  • Full featured
    • rgba
    • hsla
    • hsva
    • hex
    • ansi
    • ...
  • No rely on UIKit/AppKit
  • Expressive API
  • Complete Documentation
  • Comprehensive Test Coverage
  • from&to UIColor&NSColor
  • Material & CSS Colors

API

Creation

let color = Color(red: 50, green: 100, blue: 150, alpha: 1)
let color = Color(hue: 150, saturation: 50, lightness: 50, alpha: 1)
let color = Color(hue: 300, saturation: 70, value: 70, alpha: 1)

let color = Color(hex: "#aaa")         // "#" is optional
let color = Color(hex: "#ABCF")        
let color = Color(hex: "#010203")      
let color = Color(hex: "#01020304")    

let color = Color(hex: 0x0366D6)

let color = Color(rgb: "rgb(0, 100, 200)")         // the same as `Color(rgba:)"
let color = Color(rgba: "rgba(0, 100, 200, 0.3)")

let color = Color(hsv: "hsv(100, 20%, 30%)")  // the same as `Color(hsva:)"
let color = Color(hsva: "hsva(100, 20%, 30%, 0.3)")

let color = Color(hsl: "hsl(100, 20%, 30%)")  // the same as `Color(hsla:)"
let color = Color(hsla: "hsla(100, 20%, 30%, 0.3)")

let color = Color.rgb(100, 200, 300)
let color = Color.hsl(100, 20, 30)
let color = Color.hsv(100, 20, 30)
let color = Color.hex("#0a0b0c")
let color = Color.hex(0x0366D6)

let color = Color.Material.red50
let color = Color.Material.purple500
let color = Color.CSS.navy
let color = Color.CSS.tomato
// ...

properties

let color = Color(hex: "#010203")
color.rgba      // (red: Int, green: Int, blue: Int, alpha: Double)
color.hsva      // (hue: Int, saturation: Double, value: Double, alpha: Double)
color.hsla      // (hue: Int, saturation: Double, lightness: Double, alpha: Double)

color.isDark    // true or false
color.isLight   // true or false
color.isWhite   // true or false
color.isBlack   // true or false
color.negate

color.ansi16
color.ansi256

color.random    // a random color

Install

dependencies: [
    .package(url: "https://github.com/luoxiu/Rainbow", from("0.1.0"))
]
pod 'RainbowPod', '~> 0.1.0'

Acknowledge

Inspired by the awesome javascript library color.

Related

  • Chalk - 🖍 Expressive styling on terminal string.

Contribute

If you find a bug, open an issue, if you want to add new features, feel free to submit a pull request. Any contributing is welcome at all times!