Need help with AndroidPicker?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

gzu-liyujiang
5.2K Stars 1.3K Forks Other 480 Commits 125 Opened issues

Description

安卓选择器类库,包括日期及时间选择器(可用于出生日期、营业时间等)、单项选择器(可用于性别、民族、职业、学历、星座等)、二三级联动选择器(可用于车牌号、基金定投日期等)、城市地址选择器(分省级、地市级及区县级)、数字选择器(可用于年龄、身高、体重、温度等)、日历选日期择器(可用于酒店及机票预定日期)、颜色选择器、文件及目录选择器、图片选择器等……WheelPicker/DatePicker/TimePicker/OptionPicker/NumberPicker/LinkagePicker/AddressPicker/CarNumberPicker/CalendarPicker/ColorPicker/FilePicker/ImagePicker etc.

Services available

!
?

Need anything else?

Contributors list

AndroidPicker

API 19+ Release APK

安卓选择器类库,包括日期及时间选择器(可用于出生日期、营业时间等)、单项选择器(可用于性别、民族、职业、学历、星座等)、二三级联动选择器(可用于车牌号、基金定投日期等)、城市地址选择器(分省级、地市级及区县级)、数字选择器(可用于年龄、身高、体重、温度等)、日历选日期择器(可用于酒店及机票预定日期)、颜色选择器、文件及目录选择器等……

欢迎大伙儿在Issues提交你的意见或建议。欢迎 Fork & Pull requests 贡献您的代码,大家共同学习【AndroidPicker 交流群 604235437】。

  • GitHub:https://github.com/gzu-liyujiang/AndroidPicker
  • 码云(GitEE):https://gitee.com/liyujiang/AndroidPicker

接入指引

最新版本:jitpack更新日志

注意事项

依赖配置

allprojects {
    repositories {
        maven { url 'https://www.jitpack.io' }
    }
}

所有选择器的基础窗体:

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:Common:'
}

滚轮选择器的滚轮控件:

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelView:'
}

单项/数字、二三级联动、日期/时间等滚轮选择器:

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelPicker:'
}

省市区地址选择器:

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:AddressPicker:'
}

文件/目录选择器:

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:FilePicker:'
}

颜色选择器:

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ColorPicker:'
}

日历日期选择器(README.md):

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:CalendarPicker:'
}

图片选择器(README.md):

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ImagePicker:'
}

旧版本 AndroidX 稳定版本

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:Common:2.0.0'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelPicker:2.0.0'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:FilePicker:2.0.0'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ColorPicker:2.0.0'
}

旧版本 Support 稳定版本

dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:Common:1.5.6.20181018'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelPicker:1.5.6.20181018'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:FilePicker:1.5.6.20181018'
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ColorPicker:1.5.6.20181018'
}

混淆规则

项目库混淆无需额外配置。

用法示例

常见用法请参阅 demo,高级用法请细读源码, 诸如可以重写同名的

assets/china_address.json
来自定义省市区数据, 重写同名的
DialogSheetAnimation
来自定义弹窗动画……。 代码是最好的老师,强烈建议拉取代码运行,尝试修改 demo 对比查看实际效果以便加深理解。

在 Java 中

DialogConfig.setDialogStyle(DialogStyle.One);
...
List data = new ArrayList<>();
data.add(new GoodsCategoryBean(1, "食品生鲜"));
data.add(new GoodsCategoryBean(2, "家用电器"));
data.add(new GoodsCategoryBean(3, "家居生活"));
data.add(new GoodsCategoryBean(4, "医疗保健"));
data.add(new GoodsCategoryBean(5, "酒水饮料"));
data.add(new GoodsCategoryBean(6, "图书音像"));
OptionPicker picker = new OptionPicker(this);
picker.setTitle("货物分类");
picker.setBodyWidth(140);
picker.getWheelView().setIndicatorColor(0xFFFF0000);
picker.getWheelView().setTextColor(0xFFFF00FF);
picker.getWheelView().setSelectedTextColor(0xFFFF0000);
picker.setOnOptionPickedListener(this);
picker.getWheelLayout().setOnOptionSelectedListener(new OnOptionSelectedListener() {
    @Override
    public void onOptionSelected(int position, Object item) {
        picker.getTitleView().setText(picker.getWheelView().formatItem(position));
    }
});
picker.setData(data);
picker.setDefaultPosition(2);
picker.show();
DialogConfig.setDialogStyle(DialogStyle.Default);
...
DatePicker picker = new DatePicker(this);
picker.setBodyWidth(240);
DateWheelLayout wheelLayout = picker.getWheelLayout();
wheelLayout.setDateMode(DateMode.YEAR_MONTH_DAY);
wheelLayout.setDateLabel("年", "月", "日");
wheelLayout.setRange(DateEntity.today(), DateEntity.yearOnFuture(30), DateEntity.yearOnFuture(10));
wheelLayout.setCurtainEnabled(true);
wheelLayout.setCurtainColor(0xFFCC0000);
wheelLayout.setIndicatorEnabled(true);
wheelLayout.setIndicatorColor(0xFFFF0000);
wheelLayout.setIndicatorSize(view.getResources().getDisplayMetrics().density * 2);
wheelLayout.setTextColor(0xCCCC0000);
wheelLayout.setSelectedTextColor(0xFFFF0000);
wheelLayout.getYearLabelView().setTextColor(0xFF999999);
wheelLayout.getMonthLabelView().setTextColor(0xFF999999);
wheelLayout.getDayLabelView().setTextColor(0xFF999999);
picker.setOnDatePickedListener(this);
picker.show();
DialogConfig.setDialogStyle(DialogStyle.Three);
...
AddressPicker picker = new AddressPicker(this);
picker.setAddressMode("city.json", AddressMode.PROVINCE_CITY_COUNTY,
        new AddressJsonParser.Builder()
                .provinceCodeField("code")
                .provinceNameField("name")
                .provinceChildField("city")
                .cityCodeField("code")
                .cityNameField("name")
                .cityChildField("area")
                .countyCodeField("code")
                .countyNameField("name")
                .build());
picker.setDefaultValue("贵州省", "毕节地区", "纳雍县");
picker.setOnAddressPickedListener(this);
picker.show();

在 XML 中

<com.github.gzuliyujiang.wheelpicker.widget.optionwheellayout android:id="@+id/wheel_option" android:layout_width="90dp" android:layout_height="150dp" android:layout_gravity="center_horizontal" app:wheel_itemtextalign="center"></com.github.gzuliyujiang.wheelpicker.widget.optionwheellayout>

<com.github.gzuliyujiang.wheelpicker.widget.datewheellayout android:layout_width="120dp" android:layout_height="150dp" android:layout_gravity="center_horizontal" app:wheel_datemode="month_day" app:wheel_daylabel="日" app:wheel_monthlabel="月"></com.github.gzuliyujiang.wheelpicker.widget.datewheellayout>

...

自定义样式

全局配置所有选择器样式及配色

//4.0.0版本开始内置支持四种弹窗样式(Default、One、Two、Three),效果可运行Demo查看
public class DemoApp extends Application {

@Override
public void onCreate() {
    super.onCreate();
    DialogConfig.setDialogStyle(DialogStyle.Default);
    DialogConfig.setDialogColor(new DialogColor()
            .cancelTextColor(0xFF999999)
            .okTextColor(0xFF0099CC));
}

}

app/.../res/values/styles.xml
中重写
WheelDefault
覆盖


在Java中集成重写某一选择器样式及配色

//仿蚂蚁财富APP定投周期选择弹窗样式
public class AntFortuneLikePicker extends LinkagePicker {
    private int lastDialogStyle;

public AntFortuneLikePicker(@NonNull Activity activity) {
    super(activity);
}

@Override
protected void onInit(@NonNull Context context) {
    super.onInit(context);
    lastDialogStyle = DialogConfig.getDialogStyle();
    DialogConfig.setDialogStyle(DialogStyle.Default);
}

@Override
public void onDismiss(DialogInterface dialog) {
    super.onDismiss(dialog);
    DialogConfig.setDialogStyle(lastDialogStyle);
}

@Override
protected void initData() {
    super.initData();
    setBackgroundColor(0xFFFFFFFF);
    cancelView.setText("取消");
    cancelView.setTextSize(16);
    cancelView.setTextColor(0xFF0081FF);
    okView.setTextColor(0xFF0081FF);
    okView.setText("确定");
    okView.setTextSize(16);
    titleView.setTextColor(0xFF333333);
    titleView.setText("定投周期");
    titleView.setTextSize(16);
    wheelLayout.setData(new AntFortuneLikeProvider());
    wheelLayout.setAtmosphericEnabled(true);
    wheelLayout.setVisibleItemCount(7);
    wheelLayout.setCyclicEnabled(false);
    wheelLayout.setIndicatorEnabled(true);
    wheelLayout.setIndicatorColor(0xFFDDDDDD);
    wheelLayout.setIndicatorSize((int) (contentView.getResources().getDisplayMetrics().density * 1));
    wheelLayout.setTextColor(0xFF999999);
    wheelLayout.setSelectedTextColor(0xFF333333);
    wheelLayout.setCurtainEnabled(false);
    wheelLayout.setCurvedEnabled(false);
}

}

效果预览

以下图片显示的效果可能已修改过,实际效果请运行 demo 查看。

  • 效果图
  • 效果图
  • 效果图
  • 效果图
  • 效果图
  • 效果图
  • 效果图
  • 效果图
  • 效果图

特别鸣谢

许可协议

3.0.0 之后

Copyright (c) 2020-2021 gzu-liyujiang <[email protected]>

The software is licensed under the Mulan PSL v2. You can use this software according to the terms and conditions of the Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at: http://license.coscl.org.cn/MulanPSL2 THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE. See the Mulan PSL v2 for more details.

3.0.0 之前

MIT License

Copyright (c) 穿青山魈人马

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.