這篇筆記源自一個實際需求:銀行卡綁定時要讓使用者選擇支行所在的省市。做法是用 UIPickerView 做兩列聯動,並把整個控制項封裝成可重複使用的元件。示範以 Objective-C 撰寫(專案為 Swift 與 OC 混編,但既有 VC 仍以 OC 為主),原理與 Swift 相同。
效果如上:第一列選省之後,第二列會自動更新為該省下轄的市;按下完成後,上方 Label 顯示所選省市名稱與對應行政區編碼。
省市名稱、行政區編碼與從屬關係,網路上到處都有,權威版本則以國家統計局公布的資料為準。原始素材是一份含兩個工作表的 Excel:第一個 Sheet 放省與省碼,第二個 Sheet 放市、市碼與所屬省。
原本想用 OC 或 Swift 直接解析 Excel,但評估後覺得成本偏高,於是改走另一條路:用 PHP 的 PHPExcel 讀檔,整理成 JSON 給 iOS 端使用。iOS 端拿到 JSON 後解析並存成 plist,之後就能離線讀取。
(若資料量較大,也可以改用 SQLite:建省表與市表,以省碼作為外鍵建立一對多關聯。本文採用 plist,因為資料量小、實作單純。)
用 PHPExcel_IOFactory 建立讀取器,載入 province.xls 後取得代表該檔案的操作物件:
以 setActiveSheetIndex() 依索引(由左至右 0..n)選取工作表,再用 getActiveSheet() 取得該表,之後即可逐列逐欄讀值。每欄存入 $tempRowArray,每行存入 $tempSheetArray,最後整個 Sheet 存入 $dataArray。
把 $dataArray 印出來確認結構正確,是省下大量除錯時間的關鍵習慣。每完成一個小模組就驗證一次,出問題時能立刻定位。
目標結構是一個陣列,每個元素是一個代表「省」的字典,內含省碼 Code、省名 Name 與城市陣列 Citys;Citys 中每個元素又是代表「市」的字典,含市名 Name 與市碼 Code。
實作上,$allDataArray 存全部資料,$provinceTempData 暫存當前省,$currentProvinceCitys 存該省下所有市;迴圈中的條件判斷負責把兩個 Sheet 的資料串起來。
處理完後將 $allDataArray 做 JSON 編碼輸出,結構與上面的設計圖一一對應。
用 NSURLSessionDataTask 請求上述 PHP 檔取得 JSON,解析成陣列後透過 NSFileManager 寫入沙盒。之後要使用時,直接把 plist 從模擬器沙盒複製進專案即可。
執行後可在沙盒中找到 province.plist,其結構即為前述的省市結構。
封裝的目標不只是「能用」,還要兼顧易用性與可擴充性。以下是一個輕量但完整的封裝。
ProvincePickerView 是封裝後的元件;province.plist 是資料來源;ProvinceModel 承載目前選取的省市名稱與編碼。
ProvinceModel 的四個屬性:provinceCode、provinceName、cityCode、cityName。
初始化 ProvincePickerView、加到目標視圖上,並設定完成時的回呼 Block。Block 會在使用者按下完成鈕時帶回 ProvinceModel。
顯示時只要呼叫 showPickerView,元件會從底部彈出;因為本身就帶有取消鈕,取消後會自動收起,外部不必再提供隱藏方法。
封裝的核心其實就是 UIPickerViewDelegate 與 UIPickerViewDataSource 的實作,加上顯示/隱藏的位置安排。由於篇幅限制,此處僅列出關鍵片段,完整程式碼(含 PHP 與 PickerView 實作)請見:
github:https://github.com/lizelu/ProvincePickerDemo