宣告：本文為博主原創文章，轉載請註明出處：小嵩的部落格

一、介紹

Android-PickerView是一款仿iOS的PickerView控制元件，並封裝了時間選擇和選項選擇這兩種選擇器，詳細特性如下：

WheelView —— 基礎控制元件

• 帶有3D圓弧效果。
• 支援文字、顏色、大小設定。
• 支援背景顏色設定。
• 支援item的分隔線設定。
• 支援item間距設定。
• 支援設定是否迴圈。

OptionsPickerView —— 選項選擇器

• 支援一、二、三級聯動資料。
• 支援一、二、三級不聯動資料。
• 支援自定義佈局。
• 支援自定義標題欄。
• 支援“省，市，區”等選項的單位（label）顯示、隱藏和自定義。
• 支援dialog 模式顯示。
• 支援自定義設定容器。

TimePickerView —— 時間選擇器

• 支援選擇年、月、日的範圍。
• 支援年月日時分秒顯示。
• 支援設定當前預設時間。
• 支援自定義佈局。
• 支援自定義標題欄。
• 支援“年，月，日，時，分，秒”等選項的單位（label）顯示、隱藏和自定義。
• 支援dialog 模式顯示。
• 支援自定義設定容器。

其中，WheelView 可在XML佈局中直接引用：

<com.bigkoo.pickerview.lib.WheelView
            android:id="@+id/wv_options"
            android:layout_width="match_parent"
 

            android:layout_height="wrap_content" />

TimePickerView —— 時間選擇器，支援年月日時分，年月日，年月，時分等格式 ,效果如下：

OptionsPickerView —— 選項選擇器，支援一，二，三級選項選擇，並且可以設定是否聯動 ，效果如下：

二、使用

1.新增 Jcenter 倉庫 Gradle 依賴：

compile 'com.contrarywind:Android-PickerView:3.x'
//注：實際引入請把"3.x"替換成具體版本號，最新版本號請以GitHub上面提供的為準
 

2.在專案中新增如下程式碼：

//時間選擇器
 pvTime = new TimePickerView.Builder(MainActivity.this, new TimePickerView.OnTimeSelectListener() {
            @Override
            public void onTimeSelect(Date date,View v) {//選中事件回撥
                tvTime.setText(getTime(date));
            }
        })
             .build();
 pvTime.show();

或者

//條件選擇器
 pvOptions = new  OptionsPickerView.Builder(MainActivity.this, new OptionsPickerView.OnOptionsSelectListener() {
            @Override
            public void onOptionsSelect(int options1, int option2, int options3 ,View v) {
                //返回的分別是三個級別的選中位置
                String tx = options1Items.get(options1).getPickerViewText()
                        + options2Items.get(options1).get(option2)
                        + options3Items.get(options1).get(option2).get(options3).getPickerViewText();
                tvOptions.setText(tx);
            }
        }).build();
 pvOptions.setPicker(options1Items, options2Items, options3Items);
 pvOptions.show(); 

　　簡單的兩個步驟就能實現功能了，就是這麼簡單~ 如果預設的樣式不符合你的口味，請繼續往下看~

三、自定義樣式

pvTime = new TimePickerView.Builder(MainActivity.this, new TimePickerView.OnTimeSelectListener() {
            @Override
            public void onTimeSelect(Date date,View v) {//選中事件回撥
                tvTime.setText(getTime(date));
            }
        })
                .setType(TimePickerView.Type.ALL)//預設全部顯示
                .setCancelText("Cancel")//取消按鈕文字
                .setSubmitText("Sure")//確認按鈕文字
                .setContentSize(18)//滾輪文字大小
                .setTitleSize(20)//標題文字大小
                .setTitleText("Title")//標題文字
                .setOutSideCancelable(false)//點選螢幕，點在控制元件外部範圍時，是否取消顯示
                .isCyclic(true)//是否迴圈滾動
                .setTitleColor(Color.BLACK)//標題文字顏色
                .setSubmitColor(Color.BLUE)//確定按鈕文字顏色
                .setCancelColor(Color.BLUE)//取消按鈕文字顏色
                .setTitleBgColor(0xFF666666)//標題背景顏色 Night mode
                .setBgColor(0xFF333333)//滾輪背景顏色 Night mode
                .setRange(calendar.get(Calendar.YEAR) - 20, calendar.get(Calendar.YEAR) + 20)//預設是1900-2100年
                .setDate(new Date())// 預設是系統時間*/
                .setLabel("年","月","日","時","分","秒")
                .build();

pvOptions = new  OptionsPickerView.Builder(MainActivity.this, new OptionsPickerView.OnOptionsSelectListener() {
            @Override
            public void onOptionsSelect(int options1, int option2, int options3 ,View v) {
                //返回的分別是三個級別的選中位置
                String tx = options1Items.get(options1).getPickerViewText()
                        + options2Items.get(options1).get(option2)
                        + options3Items.get(options1).get(option2).get(options3).getPickerViewText();
                tvOptions.setText(tx);
            }
        })
                .setSubmitText("確定")//確定按鈕文字
                .setCancelText("取消")//取消按鈕文字
                .setTitleText("城市選擇")//標題
                .setSubCalSize(18)//確定和取消文字大小
                .setTitleSize(20)//標題文字大小
                .setTitleColor(Color.BLACK)//標題文字顏色
                .setSubmitColor(Color.BLUE)//確定按鈕文字顏色
                .setCancelColor(Color.BLUE)//取消按鈕文字顏色
                .setTitleBgColor(0xFF333333)//標題背景顏色 Night mode
                .setBgColor(0xFF000000)//滾輪背景顏色 Night mode
                .setContentTextSize(18)//滾輪文字大小
                .setLinkage(false)//設定是否聯動，預設true
                .setLabels("省", "市", "區")//設定選擇的三級單位
                .setCyclic(false, false, false)//迴圈與否
                .setSelectOptions(1, 1, 1)  //設定預設選中項
                .setOutSideCancelable(false)//點選外部dismiss default true
                .build();

        pvOptions.setPicker(options1Items, options2Items, options3Items);//新增資料來源

四、更多

1. 如果對以上的使用還有疑問的話，可參考demo程式碼，請戳我檢視demo程式碼

2. 如果還是不能滿足產品的需求，那麼～　默哀三秒鐘… 然後把原始碼下載下來自己做改動吧，原始碼基本都寫了註釋了，我也只能幫到這兒了。GitHub專案地址：Android-PickerView

3. 關於方法名和引數的詳細說明，請參考Wiki:請戳我檢視Wiki文件，歡迎提Issue，提建議，Pull Request.