如何5分钟为iOS应用集成专业颜色选择器:Colorful安装与快速上手实战教程
【免费下载链接】Color-Picker-for-iOSColorful: iOS color picker built with Swift.项目地址: https://gitcode.com/gh_mirrors/co/Color-Picker-for-iOS
Colorful 是一个用 Swift 编写的轻量级 iOS 颜色选择器,一个圆形色轮加一条亮度滑杆,即可实现专业的取色体验,支持触感反馈、Extended sRGB 宽色域与深色模式。本教程带你用 5 分钟完成安装与集成,让颜色选择器出现在你的 iOS 应用中。
为什么选择 Colorful iOS 颜色选择器 🎨
| 特性 | 说明 |
|---|---|
| 🎯 美观 UI | 圆形色轮 + 亮度滑杆,操作直觉流畅 |
| 📳 触感反馈 | 选色时伴随细腻震动,媲美系统控件手感 |
| 🌈 宽色域 | 支持 Extended sRGB(Display P3)与标准 sRGB |
| 🌙 深色模式 | 自动适配系统明暗外观,无需额外处理 |
| 🪶 轻量 | 纯 Swift 实现,零第三方依赖 |
核心源码模块一览:
- 主控件:Colorful/Classes/ColorPicker.swift
- 色轮渲染:Colorful/Classes/ColorMapView.swift
- 色彩空间模型:Colorful/Classes/ColorfulEntity.swift
如何安装 Colorful:三种快速方式 📦
方式一:CocoaPods(推荐)
在 Podfile 中加入两行配置:
platform :ios, '10.0' pod 'Colorful', '~> 3.0'然后在终端执行:
pod install方式二:Swift Package Manager
在 Xcode 中选择File → Add Package Dependencies…,输入项目的 Git 仓库地址(与下方方式三相同),选择产品 Colorful 即可。
方式三:直接下载源码集成
git clone https://gitcode.com/gh_mirrors/co/Color-Picker-for-iOS将 Colorful/Classes/ 目录下的所有 Swift 文件拖入你的 Xcode 工程。
4行代码集成iOS颜色选择器 ⚡
安装完成后,只需几行代码就能把颜色选择器加到界面上:
import Colorful let picker = ColorPicker(frame: CGRect(x: 20, y: 100, width: 300, height: 240)) picker.addTarget(self, action: #selector(colorChanged), for: .valueChanged) picker.set(color: .red, colorSpace: .sRGB) view.addSubview(picker)三个关键知识点:
.valueChanged事件:用户每换一个颜色都会触发回调,适合实时预览picker.color:随时读取当前选中的UIColor- 色彩空间:
.sRGB与.extendedSRGB定义见 Colorful/Classes/ColorfulEntity.swift,宽色域屏幕建议选后者;set(color:colorSpace:)的实现位于 Colorful/Classes/ColorPicker.swift
3个值得了解的专业细节 🔍
- 系统级触感反馈:主控件使用
UISelectionFeedbackGenerator,移动色轮时震动细腻克制,实现见 Colorful/Classes/ColorPicker.swift。 - 色轮实时渲染:色轮图像按所选色彩空间逐像素生成,切换宽色域时画布自动换色域,核心在 Colorful/Classes/ColorMapView.swift。
- 深色模式自适应:色轮描边颜色随系统外观自动切换,界面永远协调。
快速验证:运行官方示例应用 🚀
仓库自带完整示例,最快看到完整效果:
- 打开 Example/Colorful.xcodeproj 工程
- 在 Example 目录执行
pod install - 选择模拟器或真机运行
在示例中可以体验:
- 点击红 / 紫 / 黄按钮切换初始颜色
- 拖动右侧滑杆调整亮度
- 拨动开关在 sRGB 与 Extended sRGB 间切换,直观感受宽色域差异
示例逻辑非常短,推荐通读 Example/Colorful/ViewController.swift,约 30 行代码就演示了完整集成流程。
版本要求与许可证 ✅
| 项目 | 说明 |
|---|---|
| 支持系统 | iOS 11 及以上(见 Package.swift) |
| 当前版本 | 3.0.2(见 Colorful.podspec) |
| 许可证 | new BSD License,详见 LICENSE |
总结
Colorful 让你 5 分钟就能拥有专业 iOS 颜色选择器:一行安装、四行集成,触感反馈、宽色域、深色模式一步到位。无论是绘画应用、主题换色还是配色工具,它都是简单可靠的免费之选。
【免费下载链接】Color-Picker-for-iOSColorful: iOS color picker built with Swift.项目地址: https://gitcode.com/gh_mirrors/co/Color-Picker-for-iOS
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考