您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 省市二級聯動:從 Excel 到 Plist 再到自訂 PickerView

編輯:iOS 開發綜合

寫這篇的起因是專案裡一個小需求:銀行卡綁定時要加上支行所在的省市資訊。在 iOS 上呈現這種層級資料,UIPickerView 是很合適的選擇。因為需求只要求選到市,所以做二級聯動即可,多級的原理相同。老專案是 Objective-C 寫的,雖然目前 Swift 與 OC 混編,但既有 VC 上加功能還是得用 OC,所以本文的 Demo 就用 OC,原理則完全通用。

先看一下成品:第一列選省,第二列自動跟著換成該省底下的地級市;按完成後,上方 Label 顯示所選省市與對應行政區編碼。今天的重點有兩塊——生成 PickerView 需要的資料,以及封裝這個 PickerView。

一、資料從哪來:Excel 轉 Plist

1. 先想清楚要什麼

封裝控件之前,得先有資料:省市名稱、各自的行政區編碼,以及省與市的對應關係。這些網上到處都有,權威版本可以參考國家統計局的公開數據。下面兩個 Sheet 是服務端同事給的 Excel,一個放省與省碼,一個放市與市碼並標明所屬省份,算是前後端的默契基準。

拿到 Excel 怎麼用?最初想直接用 OC 或 Swift 解析 xls,研究後發現路頗曲折,於是改走老路——用 PHP 的 PHPExcel 讀檔。之前做 PHP 開發時用過,順手又不複雜。讀出來之後重新關聯組織,編碼成 JSON 給 iOS;iOS 端下載、解析、存進 plist,之後就能直接從 plist 讀省市資料。

當然你也可以把資料倒進 SQLite,建省表與市表,用外鍵做一對多關聯,這是另一種正當解法。本文選 plist 純粹是因為資料量小、實作簡單。兩種方案都 OK,這裡只提供 plist 這條路。

2. 用 PHPExcel 讀取 Excel

第一個 Sheet 存省與省碼,第二個 Sheet 存市、市碼與所屬省。PHPExcel 的官方文件在 https://phpexcel.codeplex.com/。

(1)載入框架與 Excel 檔

透過 PHPExcel_IOFactory 建立讀取器 $objReader,用它載入 province.xls,得到代表該 Excel 的 $objPHPExcel 物件,後續所有操作都透過它進行。

(2)逐 Sheet、逐列讀出內容

$dataArray 用來存所有 Sheet 的資料。迴圈兩次,用 setActiveSheetIndex() 依索引(由左至右 0 到 n)選 Sheet,再用 getActiveSheet() 取出 $objWorksheet,就能讀該 Sheet 的每一列每欄。每欄存進 $tempRowArray,每列存進 $tempSheetArray,最後整個 Sheet 存進 $dataArray。

3. 驗證讀出來的東西对不对

結構是:$dataArray 裝各 Sheet,Sheet 裝各列,列裝各欄,正好對應整份 Excel。保險起見把 $dataArray 印出來看看。

順帶一提,養成「寫一段、驗一段」的習慣很重要。小模組做完立刻測,出問題能馬上定位;全部寫完才測,出了錯根本不知從何查起。上圖輸出中,紅框上半部是第一個 Sheet,下半部是第二個 Sheet,與預期相符,就可以往下一步走。

4. 把省市關聯起來

目標結構如下圖:最外層是陣列,每個元素是一個代表省的字典,含省碼 Code、省名 Name 與城市陣列 Citys;Citys 裡每一項又是字典,含市名 Name 與市碼 Code。

$allDataArray 存全部資料,$provinceTempData 暫存當前省的所有資訊,$currentProvinceCitys 存當前省底下的市。第二層迴圈的 if 負責比對市所屬的省,對上了就塞進該省的 Citys。

以河北省為例,輸出的 JSON 結構與上面的結構圖一一對應,正是我們要的樣子。資料處理到這裡算完成大半。

5. iOS 端下載並存入 Plist

用 NSURLSessionDataTask 請求上述 PHP 檔取得 JSON,解析成陣列後透過 NSFileManager 寫入沙盒。想在外部重複使用,直接從模擬器沙盒把 plist 拷出來即可。

執行後,沙盒裡會出現 province.plist,結構與前面設計的一致。至此,一份乾淨可用的省市資料就備好了。

二、封裝 ProvincePickerView

封裝不只是把 PickerView 包一層,還要考慮易用性與可擴充性。這裡做一個輕量封裝,重點在思路。

1. 目錄結構

因為封裝的是顯示省市的 UIPickerView,所以命名為 ProvincePickerView。外部只需實例化並加到視圖上即可使用,資料源就是 province.plist。

ProvinceModel 負責承載當前選中的省市名稱與編碼。

provinceCode 存所選省碼,provinceName 存省名,cityCode 存市碼,cityName 存市名。

2. 初始化與呼叫

初始化後加入目標視圖,再設定 Block 回呼。使用者按完成時觸發回呼,把 ProvinceModel 拋回來。

呼叫 showPickerView 就會從底部彈出。因為元件自帶取消鈕並會自動收回,所以不必對外提供隱藏方法,介面更乾淨。

三、原始碼

篇幅所限,ProvincePickerView 內部實作就不逐行貼了。核心其實就是 UIPickerViewDelegate 與 UIPickerViewDataSource 的實作,再加上顯示/隱藏的位置安排。有興趣的直接看 GitHub 上的完整程式碼,註解寫得算是齊全。

本文所有程式碼都以截圖呈現,結論處會附上完整檔案,包含 PHP 端與 PickerView 的實作。

GitHub:https://github.com/lizelu/ProvincePickerDemo

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved