Android-PickerView

You can provide a custom XML layout for the picker using .setLayoutRes(int layoutRes, CustomListener listener).

CRITICAL: When using a custom layout, you must NOT modify the IDs of the child widgets (e.g., for OptionsPicker or TimePicker). Doing so will cause a NullPointerException.

In the customLayout callback, you can manually handle clicks for the submit and cancel buttons using pv.returnData(view) and pv.dismiss() respectively.

  private void initCustomTimePicker() {
        // be careful: In the custom layout, the layout of the ID for optionspicker
        // or TimePicker and its child widget must not be modified,
        // otherwise will be reported NullPointerException

        Calendar selectedDate = Calendar.getInstance();
        Calendar startDate = Calendar.getInstance();
        startDate.set(2013,1,23);
        Calendar endDate = Calendar.getInstance();
        endDate.set(2019,2,28);

        pvCustomTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
            @Override
            public void onTimeSelect(Date date, View v) {
                btn_CustomTime.setText(getTime(date));
            }
        })       .setType(new boolean[]{true, true, true, false, false, false})// year - month - day
                .setDate(selectedDate)
                .setRangDate(startDate,endDate)
                .setLayoutRes(R.layout.pickerview_custom_time, new CustomListener() {

                    @Override
                    public void customLayout(View v) {
                        final TextView tvSubmit = (TextView) v.findViewById(R.id.tv_finish);
                        ImageView ivCancel = (ImageView) v.findViewById(R.id.iv_cancel);
                        tvSubmit.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                pvCustomTime.returnData(tvSubmit);
                            }
                        });
                        ivCancel.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                pvCustomTime.dismiss();
                            }
                        });
                    }
                })
                .setDividerColor(Color.BLACK)
                .build();
    }

You can provide a custom XML layout for the picker.

Important: The layout must contain views with IDs matching optionspicker or timepicker and their sub-controls, otherwise a NullPointerException will occur. Refer to the project's demo for valid layout structures.

Usage:

        pvCustomOptions = new OptionsPickerBuilder(this, new OptionsPickerView.OnOptionsSelectListener() {
            @Override
            public void onOptionsSelect(int options1, int options2, int options3, View v) {
                String tx = cardItem.get(options1).getPickerViewText();
                btn_CustomOptions.setText(tx);
            }
        })
                .setLayoutRes(R.layout.pickerview_custom_options, new CustomListener() {
                    @Override
                    public void customLayout(View v) {
                        // Initialize views and handle events
                        final TextView tvSubmit = (TextView) v.findViewById(R.id.tv_finish);
                        tvSubmit.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                pvCustomOptions.returnData(tvSubmit);
                            }
                        });
                        // ... other view logic
                    }
                })
                .build();
        pvCustomOptions.setPicker(cardItem);

        // 注意：自定义布局中，id为 optionspicker 或者 timepicker 的布局以及其子控件必须要有，否则会报空指针
        // 具体可参考demo 里面的两个自定义布局
        pvCustomOptions = new OptionsPickerBuilder(this, new OptionsPickerView.OnOptionsSelectListener() {
            @Override
            public void onOptionsSelect(int options1, int options2, int options3, View v) {
                String tx = cardItem.get(options1).getPickerViewText();
                btn_CustomOptions.setText(tx);
            }
        })
                .setLayoutRes(R.layout.pickerview_custom_options, new CustomListener() {
                    @Override
                    public void customLayout(View v) {
                        //自定义布局中的控件初始化及事件处理
                        final TextView tvSubmit = (TextView) v.findViewById(R.id.tv_finish);
                        final TextView tvAdd = (TextView) v.findViewById(R.id.tv_add);
                        ImageView ivCancel = (ImageView) v.findViewById(R.id.iv_cancel);
                        tvSubmit.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                pvCustomOptions.returnData(tvSubmit);
                            }
                        });
                        ivCancel.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                pvCustomOptions.dismiss();
                            }
                        });

                        tvAdd.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                getData();
                                pvCustomOptions.setPicker(cardItem);
                            }
                        });
                    }
                })
                .build();
        pvCustomOptions.setPicker(cardItem);

If you only need the underlying wheel scrolling logic without the full PickerView features, you can include the wheelview library separately.

Gradle dependency:

compile 'com.contrarywind:wheelview:4.1.0'

XML Layout:

 <com.contrarywind.view.WheelView
            android:id:@+id/wheelview"
            android:layout_width="match_parent"
            android:layout_height="wrap_content" />

Java Usage:

WheelView wheelView = findViewById(R.id.wheelview);
wheelView.setCyclic(false);

final List<String> mOptionsItems = new ArrayList<>();
mOptionsItems.add("item0");
mOptionsItems.add("item1");
  
wheelView.setAdapter(new ArrayWheelAdapter(mOptionsItems));
wheelView.setOnItemSelectedListener(new OnItemSelectedListener() {
    @Override
    public void onItemSelected(int index) {
        Toast.makeText(MainActivity.this, "" + mOptionsItems.get(index), Toast.LENGTH_SHORT).show();
    }
});

 <com.contrarywind.view.WheelView
            android:id="@+id/wheelview"
            android:layout_width="match_parent"
            android:layout_height="wrap_content" />

Use TimePickerBuilder to create a time picker. You can specify formats (Year, Month, Day, Hour, Minute, Second) using .setType().

Basic Usage:

TimePickerView pvTime = new TimePickerBuilder(MainActivity.this, new OnTimeSelectListener() {
    @Override
    public void onTimeSelect(Date date, View v) {
        Toast.makeText(MainActivity.this, getTime(date), Toast.LENGTH_SHORT).show();
    }
}).build();

Customization Example:

 pvTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
            @Override
            public void onTimeSelect(Date date,View v) {
                tvTime.setText(getTime(date));
            }
        })
                .setType(new boolean[]{true, true, true, true, true, true})
                .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)
                .setBgColor(0xFF333333)
                .setDate(selectedDate)
                .setRangDate(startDate,endDate)
                .setLabel("年","月","日","时","分","秒")
                .isCenterLabel(false)
                .isDialog(true)
                .build();

Use OptionsPickerBuilder to create a picker for hierarchical data (e.g., Province > City > District). It supports up to three levels of selection and can be configured for linkage (cascading) or independent selection.

Basic Usage:

 OptionsPickerView pvOptions = new OptionsPickerBuilder(MainActivity.this, new 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(); 

Customization Example:

pvOptions = new  OptionsPickerBuilder(this, new OptionsPickerView.OnOptionsSelectListener() {
            @Override
            public void onOptionsSelect(int options1, int option2, int options3 ,View v) {
                // ... implementation
            }
        }) .setOptionsSelectChangeListener(new OnOptionsSelectChangeListener() {
                              @Override
                              public void onOptionsSelectChanged(int options1, int options2, int options3) {
                                  // ... implementation
                              }
                          })
                .setSubmitText("确定")
                .setCancelText("取消")
                .setTitleText("城市选择")
                .setSubCalSize(18)
                .setTitleSize(20)
                .setTitleColor(Color.BLACK)
                .setSubmitColor(Color.BLUE)
                .setCancelColor(Color.BLUE)
                .setTitleBgColor(0xFF333333)
                .setBgColor(0xFF000000)
                .setContentTextSize(18)
                .setLinkage(false)
                .setLabels("省", "市", "区")
                .isCenterLabel(false)
                .setCyclic(false, false, false)
                .setSelectOptions(1, 1, 1)
                .setOutSideCancelable(false)
                .isDialog(true)
                .isRestoreItem(true)
                .build();

pvOptions.setPicker(options1Items, options2Items, options3Items);

Use OptionsPickerBuilder to create a picker for custom options. It supports up to three levels of linkage (e.g., Province > City > District).

To set the data, use .setPicker() with the appropriate number of data lists (up to 3).

//OptionsPicker
 pvOptions = new OptionsPickerBuilder(this, new OnOptionsSelectListener() {
            @Override
            public void onOptionsSelect(int options1, int option2, int options3 ,View v) {
                ////Callback
                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);
 pvOptions.setPicker(options1Items, options2Items);
 //pvOptions.setPicker(options1Items, options2Items, options3Items);
 pvOptions.show();

You can customize the appearance and behavior of the TimePickerBuilder using various setter methods.

Key customization methods:

• .setType(boolean[]): Set which units (year, month, day, etc.) are visible.
• .setRangDate(startDate, endDate): Set the selectable date range.
• .setLabel(String...): Customize the unit labels.
• .isCyclic(boolean): Enable/disable cyclic scrolling.
• .setCancelText(String) / .setSubmitText(String): Customize button text.
• .setBgColor(int) / .setTitleBgColor(int): Customize background colors.

 Calendar selectedDate = Calendar.getInstance();
 Calendar startDate = Calendar.getInstance();
 startDate.set(2013,0,1);
 Calendar endDate = Calendar.getInstance();
 endDate.set(2020,11,1);

 pvTime = new TimePickerBuilder(this, new OnTimeSelectListener() {
            @Override
            public void onTimeSelect(Date date,View v) {//callback
                tvTime.setText(getTime(date));
            }
        })
                .setType(new boolean[]{false, false, false, true, true, false})// type of date 
                .setCancelText("Cancel")
                .setSubmitText("Sure")
                .setContentSize(18)
                .setTitleSize(20)
                .setTitleText("Title")
                .setOutSideCancelable(false)// default is true
                .isCyclic(true)// default is false
                .setTitleColor(Color.BLACK)
                .setSubmitColor(Color.BLUE)
                .setCancelColor(Color.BLUE)
                .setTitleBgColor(0xFF666666)//night mode
                .setBgColor(0xFF333333)//night mode
                .setRangDate(startDate,endDate)
                .setLabel("year","month","day","hours","mins","seconds")
                .build();