中国行政区划选择器:ChineseSubdivisionsPicker
中国行政区划选择器
ChineseSubdivisionsPicker is a simple Chinese Subdivisions picker inherited from UIPickerView and written in Swift.
中国行政区划选择器继承自 UIPickerView,使用 swift 实现。
You can let user pick province, city and district data from it.
用户可以选择省、市或区。你可以定制选择器的最小选择粒度。
Campatible from iOS7 to iOS9.
Usage
let myPicker = ChineseSubdivisionsPicker() //You can also use Interface Builder to create a ChineseSubdivisionsPicker myPicker.pickerType = .District myPicker.pickerDelegate = self
Basics
pickerType: ChineseSubdivisionsPicker.ChineseSubdivisionsPickerType
Available picker types are.Province.Cityand.DistrictPicker type is.Districtin default.
可选的选择器类型为.Province(只可选择省份).City(可选择省市) and.District(可选择省市区),默认的选择器类型是.District(可选择省市区)。
pickerDelegate: ChineseSubdivisionsPickerDelegate
You should implementsubdivisionsPickerDidUpdate()in your pickerDelegate (a UIViewController in usual) to receive callback when picker value is changed.
你需要在你的 pickerDelegate(通常是一个 UIViewController)里实现subdivisionsPickerDidUpdate()方法,ChineseSubdivisionsPicker 会在更新选定的省市区时调用这个方法。
province, city, district: String?
You can fetch current province, city and district name.
可通过province,city,district属性获取到目前选择的省市区的名字。
Note
ChangingdataSourceordelegateof ChineseSubdivisionsPicker will not work. You should changepickerDelegateinstead for receiving callback.
注意,ChineseSubdivisionsPicker 的dataSource和delegate是无法修改的 (否则 Picker 无法正常工作)。如果你想要接受回调,应该修改pickerDelegate属性。
Installation
CocoaPods
ChineseSubdivisionsPicker is available through CocoaPods. To install it, simply add the following lines to your Podfile:
iOS8 or later
use_frameworks! pod 'ChineseSubdivisionsPicker'
Due to iOS limitation, you can not intergrate swift file (such as ChineseSubdivisionsPicker) with cocoapods in project which deployment targer is iOS7. But you can followTo manually add to your projectbelow.
To manually add to your project
- Add all files inChineseSubdivisionsPicker/to your project
- that's all!