阅读 UIColor-Hex-Swift 源码

由于种种原因,简书等第三方平台博客不再保证能够同步更新,欢迎移步 GitHub:https://github.com/kingcos/Perspective/。谢谢!

Read the mind behind the code.

  • Info:
  • Swift 3.0
  • Xcode 8.2.1
  • UIColor Hex Swift 3.0.2

前言

yeahdongcn/UIColor-Hex-Swift

yeahdongcn/UIColor-Hex-Swift 是一个使用 Swift 3.0 编写并开源在 GitHub 上的 iOS 第三方库。核心为不到 200 行代码,即可以使用 RGBA 十六进制数/字符串创建颜色(UIColor)。其支持通过 CocoaPods 管理,目前在 GitHub 上已经拥有 683 Stars,说明该库已经帮助了不少开发者使用在了项目中。而我作为一个新手,就来仔细阅读一下该库的源码,看看是否有值得借鉴的地方。

错误处理

利用枚举,通过遵守 Error 协议,来定义统一的错误处理。Swift 中的 Error 协议也有说明,通过遵守该协议即可使错误在 Swift 的错误处理系统中保持一致性。

public enum UIColorInputError : Error {
    case missingHashMarkAsPrefix,
    unableToScanHexValue,
    mismatchedHexStringLength
}

扩展

Swift 中的扩展(extension)能够很方便地扩充而不破坏原有的类。特别是在官方提供的类上,使用 extension 可以很容易的加上我们的自定义方法以及计算属性(扩展不支持存储属性)。

extension UIColor {
}

便利构造器

便利构造器(Convenience initializers)与指定构造器(Designated initializers)不同。便利构造器是次要的,即不是必需的。也可以在便利构造器的内部调用指定构造器。

public convenience init(hex3: UInt16, alpha: CGFloat = 1) {
    let divisor = CGFloat(15)
    let red     = CGFloat((hex3 & 0xF00) >> 8) / divisor
    let green   = CGFloat((hex3 & 0x0F0) >> 4) / divisor
    let blue    = CGFloat( hex3 & 0x00F      ) / divisor
    self.init(red: red, green: green, blue: blue, alpha: alpha)
}

注释

一般的单行注释和多行注释都已为人所知。但如何与官方注释保持一致性和规范性,我个人却在之前没有了解到。在 Xcode 8 支持了 markdown 语法后,有人已经开始通过 Playground 制作很多带样式的代码教程。结合 Xcode 自带的规范,可以达到和官方保持一致的效果。关于具体的标记样式可以查看文末的参考。

带样式的 Xcode 注释
     /**
     The shorthand three-digit hexadecimal representation of color.
     #RGB defines to the color #RRGGBB.
     
     - parameter hex3: Three-digit hexadecimal value.
     - parameter alpha: 0.0 - 1.0. The default is 1.0.
     */
    public convenience init(hex3: UInt16, alpha: CGFloat = 1) {
        let divisor = CGFloat(15)
        let red     = CGFloat((hex3 & 0xF00) >> 8) / divisor
        let green   = CGFloat((hex3 & 0x0F0) >> 4) / divisor
        let blue    = CGFloat( hex3 & 0x00F      ) / divisor
        self.init(red: red, green: green, blue: blue, alpha: alpha)
    }

Travis CI

Travis CI,是一个专门为开源项目打造的持续集成环境。最为显著的标示就是在很多 GitHub 等开源的项目 README 中,有很多简介项目的标签。我也正准备将自己的项目建立 Travis CI。

Travis CI 标签

十六进制转 RGB

以六位十六进制转换 RGB 为例。& 是按位与运算符。>> 是右移运算符。通过 (hex6 & 0xFF0000) >> 16(hex6 & 0x00FF00) >> 8hex6 & 0x0000FF,分别把 RR、GG、BB 位上的数字提取。由于 RGB 最大值为 255.0,iOS 中 UIColor 的初始化方法必须按与 255.0 的比例作为参数,因此比上除数 255.0。

/**
     The six-digit hexadecimal representation of color of the form #RRGGBB.
     
     - parameter hex6: Six-digit hexadecimal value.
     */
    public convenience init(hex6: UInt32, alpha: CGFloat = 1) {
        let divisor = CGFloat(255)
        let red     = CGFloat((hex6 & 0xFF0000) >> 16) / divisor
        let green   = CGFloat((hex6 & 0x00FF00) >>  8) / divisor
        let blue    = CGFloat( hex6 & 0x0000FF       ) / divisor
        self.init(red: red, green: green, blue: blue, alpha: alpha)
    }

参考资料

Error Handling
Extensions
Initialization
Markup Formatting Reference

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容

  • 嗯哼嗯哼蹦擦擦~~~ 转载自:https://github.com/Tim9Liu9/TimLiu-iOS 目录 ...
    philiha阅读 4,835评论 0 6
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,016评论 4 62
  • 夏季北方家里最常做的是面条,凉水过面,才好吃。蒜汁凉面,西红柿鸡蛋面,炸酱面,卤面,茄子肉丁面等等,都是最爱! 【...
    修味阅读 968评论 3 12
  • 九年不见的老同学,阿宝,突然相见了。 复读班同学~~ 咋办? 喝一壶呗! 我这人没原则,口口声声地说不喝酒了,但,...
    王小二日记阅读 1,583评论 2 3
  • 第1天 各地-长白山 08:00 交通: 【机场接机】自行抵达长白山机场,抵达后,出机场乘坐万达度假区统一安排巴士...
    健康牛牛妈阅读 302评论 0 1