Swift 4
安装
CyaneaOctopus 可通过 CocoaPods 获取。要安装它,只需将以下行添加到 Podfile 中。
pod 'CyaneaOctopus'
附加安装
CyaneaOctopus.clr 这是一个用于 Interface Builder(以及其他使用颜色库的 Mac 应用)的颜色调色板库。要安装,从 Finder > 前往,按住 选项键
并单击 库。将 .clr 文件复制到 /Library/Colors
CyaneaOctopus.aco 这是一个针对 Adobe 产品的颜色调色板刻板。您可以通过在刻板面板中单击 加载刻板... 按钮来加载此刻板。
简介
CyaneaOctopus 是一个适用于 iOS 的轻量级且功能强大的纯 Swift 编写的颜色框架。它基于由 Vicc Alexander 开发的 Chameleon 框架。由于 Chameleon 框架似乎已经被遗弃,因此在这里将其重建为 CyaneaOctopus(另一种可以改变颜色的动物)。
借助CyaneaOctopus,您可以轻松停止对RGB值的调整,避免浪费数小时去寻找合适的颜色组合使用在您的应用程序中,也不必担心文本在应用程序的各种背景颜色上是否可读。
功能
- 2种色调下的24种颜色
- 渐变色
- 从图像生成颜色
- 调整任何颜色的亮度或暗度
- 支持十六进制颜色
- 全局应用程序主题
- Swift 4.2
🌟 产品功能
100%平面
CyaneaOctopus提供了超过24种精心挑选的颜色,这些颜色分为浅色和深色两种色调。
从图像中获取颜色
CyaneaOctopus可让您轻松地从图像中提取非平面或平面颜色方案,无需繁琐的操作。您还可以轻松地生成图像的平均颜色。现在您可以根据图像调整个人资料或产品的UI颜色!
⚠️ 要求
- Swift
- Swift 至少需要iOS 9.0。
- 使用任何iOS项目都需要Xcode 6.3。
🔑 许可证
CyaneaOctopus在MIT许可证的条款和条件下发布和分发。
👥 贡献
如果您遇到问题,请打开一个问题报告。我们积极欢迎pull requests。通过为CyaneaOctopus做出贡献,您同意您的贡献将根据其MIT许可证许可。
📗 文档
CyaneaOctopus中所有可用的方法、属性和类型均在以下进行文档说明。
安装
CyaneaOctopus 可通过 CocoaPods 获取。要安装它,只需将以下行添加到 Podfile 中。
pod 'CyaneaOctopus'
手动安装
如果您愿意手动安装此框架,只需将 CyaneaOctopus 文件夹拖放到您的项目中,并确保您勾选以下复选框。
使用方法
要使用 CyaneaOctopus 中的功能,请包含以下导入
如果你使用 Cocoapods 安装 CyaneaOctopus
Swift
import CyaneaOctopus
UIColor 方法
常规方法
Swift
view.backgroundColor = UIColor.flatGreenDark
CyaneaOctopus 缩写
Swift
view.backgroundColor = FlatGreenDark()
设置浅色的颜色与设置深色的颜色相同,只是不加 Dark 后缀。(默认情况下,所有不带 Dark 后缀的颜色都是浅色)。例如
常规用法
Swift
view.backgroundColor = UIColor.flatGreen
CyaneaOctopus 缩写
Swift
view.backgroundColor = FlatGreen()
渐变颜色
通过传入一个视图到颜色、一个UIColors数组和一个渐变方向,可以创建渐变颜色。
Swift
let colors : [UIColor] = [.flatBlueColor(),.flatRedColor(),.flatGreenColor()]
UIColor.gradientColor(view: view, colors: colors, direction: .leftToRight)
8 可能的渐变方向
- 上至下
- 左至右
- 下至上
- 右至左
- 左上至右下
- 右上至左下
- 左下至右上
- 右下至左上
随机颜色
生成随机单色颜色有四种方式。如果您对颜色是浅色调还是深色调没有偏好,您可以这样做
常规
Swift
view.backgroundColor = UIColor.randomFlat
CyaneaOctopus 简写
Swift
view.backgroundColor = RandomFlatColor()
UI阴影样式
UIShadeStyleLight
(Swift中的UIShadeStyle.Light
)UIShadeStyleDark
(Swift中的UIShadeStyle.Dark
)
十六进制颜色
最受欢迎的功能之一,十六进制颜色,现已提供。您只需简单地提供一个带或不带#符号的十六进制字符串。
常规用法
Swift
UIColor(hexString:string)
CyaneaOctopus 缩写
Swift
HexColor(hexString)
十六进制值
获取UIColor
的hexValue
同样简单。
Swift
FlatGreen.hexValue //Returns @"2ecc71"
浅色和深色颜色
有时你所需要的仅仅是将颜色调整为浅一些或者深一些。好吧,对于这些罕见但至关重要的时刻,CyaneaOctopus为你提供了解决方案。你现在可以通过以下方法将任何颜色变亮:
常规方法
Swift
color.lightenByPercentage(percentage: CGFloat)
你也可以生成一个颜色更深版本的颜色
常规方法
Swift
color.darkenByPercentage(percentage: CGFloat)
改变图片颜色
Cyanea Octopus支持对UIImages进行颜色叠加和着色。
着色
let dice = UIImage(named: "test")?.tint(.red)
所有灰度颜色都着上了所需的颜色。
着色
let dice = UIImage(named: "test")?.overlayColor(.yellow)
alpha通道被全色着色。
从图片中提取颜色
CyaneaOctopus 现在支持从图片中提取颜色。您可以从图片中生成平铺和非平铺的颜色方案,或者轻松提取平均颜色。
要生成颜色方案,请按照以下步骤操作
常规方法
CyaneaOctopus 简写
Swift
ColorsFromImage(image, isFlatScheme)
要从图片中提取平均颜色,您也可以这样做
常规方法
Swift
UIColor(averageColorFromImage: UIImage)
👑 作者
CyaneaOctopus 由 Adam McElhaney 开发于 2018 年,使用 Swift 4.2 编写。目前,由 @adammcelhaney 维护。
📝 待办事项列表
- 添加颜色柔化功能
- 添加带色调的颜色
- 添加互补色
🚗 路线图
- 添加“夜间模式”功能,可实时切换不同的主题。