這一期整理了三個實用的小開源與一個自造輪子的思路,涵蓋菜單動效、進度條定製、歸檔解檔與手勢繪圖,都是日常專案裡很容易碰到的場景。
如果你做過資訊類產品,大概都遇過「頂部橫向菜單 + 下劃線滑動 + 選中標題漸變」這一套組合。RBPageMenu 把這個效果封裝成了可直接接入的元件,支援 Swift 3.0,切換時下劃線跟手移動,文字顏色同步過渡,視覺上比單純的 highlight 自然很多。

UIProgressView 是系統裡存在感偏低的一個控件,屬性和方法都寥寥可數,讀一遍文件就夠了。但它有個讓人頭疼的地方:無論你怎麼改 frame 的 height,進度條就是不肯變粗。
最直接的解法是用座標變換把它「拉」起來:
progressView.transform = CGAffineTransformMakeScale(1.0f, 5.0f);
這招應急可以,但一旦需求變複雜就捉襟見肘了。比如筆者當時的專案不僅要求進度條高度可配置,還要在條上疊一層文字說明。系統控件既然這麼固執,乾脆自己動手,於是有了 XDProgressView —— 用 CALayer 加 UIView 拼出來,對外 API 盡量貼近原生 UIProgressView 的習慣,遷移成本壓到最低。

Objective-C 時代有 MJExtension 這類工具,一行 macro 就能搞定模型與字典的互轉,歸檔解檔 likewise 不太費勁。換到 Swift 之後,沒有巨集、運行時能力也受限,NSCoding 的 encode / decode 只能一個屬性一個屬性地寫。屬性一多, boilerplate 程式碼漲得比業務邏輯還快,這正是 JXAutoEncoder 誕生的原因。
它的原理是借助 Swift Reflect 遍歷物件的屬性清單,自動完成編碼與解碼;使用方式也很輕:讓你的 Model 繼承 JXAutoEncoder, encode(with:) 與 required init?(coder:) 就不用再自己實作了。
先看改造前的樣子,一個再普通不過的 NSCoding 模型:
class ArchiverModel: NSObject, NSCoding { var bool = true var int = 1 var double = M_PI var string = "" var array = ["123", "456"] var dictionary = ["abc": "cba"] var data = "hello world".data(using: String.Encoding.utf8) var date = Date() /// 歸檔到文件 func archiveToFile() { var modelFile = NSSearchPathForDirectoriesInDomains(FileManager.SearchPathDirectory.documentDirectory, FileManager.SearchPathDomainMask.userDomainMask, true)[0] modelFile += "/model.data" NSKeyedArchiver.archiveRootObject(self, toFile: modelFile) } /// 從文件中解檔 /// /// - Returns: 解檔後的Model class func decodedFromFile() throws -> ArchiverModel { var modelFile = NSSearchPathForDirectoriesInDomains(FileManager.SearchPathDirectory.documentDirectory, FileManager.SearchPathDomainMask.userDomainMask, true)[0] modelFile += "/model.data" if FileManager.default.fileExists(atPath: modelFile) { if let model = NSKeyedUnarchiver.unarchiveObject(withFile: modelFile) as? ArchiverModel { return model }else{ throw NSError(domain: "Unarchive fail", code: 100, userInfo: nil) } }else{ throw NSError(domain: "File doesn't exists", code: 101, userInfo: nil) } } required init?(coder aDecoder: NSCoder) { super.init() if let boolValue = aDecoder.decodeObject(forKey: "bool") as? Bool { bool = boolValue } if let intValue = aDecoder.decodeObject(forKey: "int") as? Int { int = intValue } if let doubleValue = aDecoder.decodeObject(forKey: "double") as? Double { double = doubleValue } if let stringValue = aDecoder.decodeObject(forKey: "string") as? String { string = stringValue } if let arrayValue = aDecoder.decodeObject(forKey: "array") as? [String] { array = arrayValue } if let dictionaryValue = aDecoder.decodeObject(forKey: "dictionary") as? [String: String] { dictionary = dictionaryValue } if let dataValue = aDecoder.decodeObject(forKey: "data") as? Data { data = dataValue } if let dateValue = aDecoder.decodeObject(forKey: "date") as? Date { date = dateValue } } func encode(with aCoder: NSCoder) { aCoder.encode(bool, forKey: "bool") aCoder.encode(int, forKey: "int") aCoder.encode(double, forKey: "double") aCoder.encode(string, forKey: "string") aCoder.encode(string, forKey: "array") aCoder.encode(string, forKey: "dictionary") aCoder.encode(string, forKey: "data") aCoder.encode(string, forKey: "date") } }換成 JXAutoEncoder 之後,只剩業務本身該關心的部分:
import JXAutoEncoder class ArchiverModel: JXAutoEncoder { /// 歸檔到文件 func archiveToFile() { var modelFile = NSSearchPathForDirectoriesInDomains(FileManager.SearchPathDirectory.documentDirectory, FileManager.SearchPathDomainMask.userDomainMask, true)[0] modelFile += "/model.data" NSKeyedArchiver.archiveRootObject(self, toFile: modelFile) } /// 從文件中解檔 /// /// - Returns: 解檔後的Model class func decodedFromFile() throws -> ArchiverModel { var modelFile = NSSearchPathForDirectoriesInDomains(FileManager.SearchPathDirectory.documentDirectory, FileManager.SearchPathDomainMask.userDomainMask, true)[0] modelFile += "/model.data" if FileManager.default.fileExists(atPath: modelFile) { if let model = NSKeyedUnarchiver.unarchiveObject(withFile: modelFile) as? ArchiverModel { return model }else{ throw NSError(domain: "Unarchive fail", code: 100, userInfo: nil) } }else{ throw NSError(domain: "File doesn't exists", code: 101, userInfo: nil) } }最後是一個可以直接拿去用的小玩具:用手勢在螢幕上塗鴉,路徑以貝塞爾曲線平滑,避免線條出現生硬的折角。相關實作沒有單獨拆出來,都放在測試 demo 裡, clone 下來看 ViewController 就能明白接入方式。
