gzu-liyujiang/ AndroidPicker

(2.0.0) 4 months ago

Java

timepicker

wheelview

citypicker

Shell

View on GitHub

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.0K Stars

1.3K Forks

MIT License

367 Commits

117 Opened issues

Description

【抱歉，暂停维护，替代品：https://github.com/Bigkoo/Android-PickerView】安卓选择器类库，包括日期选择器、时间选择器、单项选择器、双项选择器、城市地址选择器、车牌号选择器、数字选择器、星座选择器、生肖选择器、颜色选择器、文件选择器、目录选择器等……WheelPicker/DateTimePicker/DatePicker/TimePicker/SinglePicker/NumberPicker/DoublePicker/LinkagePicker/AddressPicker/CalendarPicker/ColorPicker/FilePicker etc.

Services available

Need anything else?

Contributors list

Readme

Summary

Name: AndroidPicker
Brand: AndroidPicker
SKU: //gzu-liyujiang/AndroidPicker
Rating: 4.443 (4987 reviews)

安卓选择器类库，包括日期及时间选择器（可设置范围）、单项选择器（可用于性别、职业、学历、星座等）、城市地址选择器（分省级、地级及县级）、数字选择器（可用于年龄、身高、体重、温度等）、双项选择器、颜色选择器、文件及目录选择器等…… 欢迎大伙儿在Issues提交你的意见或建议。
欢迎Fork & Pull requests贡献您的代码，大家共同学习【AndroidPicker交流群 604235437】。查看更新日志，新版本可能未对旧版API作兼容处理，升级后若编译报错请根据错误提示更改。
~~正在重构2.x版本~~，感兴趣的小伙伴可以点击此处查看

Install

“app”是测试用例；“library”包括WheelPicker、ColorPicker、FilePicker、MultiplePicker， WheelPicker包括DatePicker、TimePicker、OptionPicker、LinkagePicker、AddressPicker、NumberPicker、DoublePicker等。其中WheelPicker、FilePicker及ColorPicker是独立的，需要用哪个就只依赖哪个，最新版本为，也可以参照此处指定具体的版本号，具体步骤如下：第一步，在项目根目录下的build.gradle里加：

repositories {
    maven {
        url "https://jitpack.io"
    }
}

第二步，在项目的app模块下的build.gradle里加：滚轮选择器：

groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:WheelPicker:版本号'
}

文件目录选择器：

groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:FilePicker:版本号'
}

颜色选择器：

groovy
dependencies {
    implementation 'com.github.gzu-liyujiang.AndroidPicker:ColorPicker:版本号'
}

注：Support版本截止1.5.6，从2.0.0开始为AndroidX版本。

Support版本依赖：

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

AndroidX版本依赖：

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

ProGuard

由于地址选择器使用了fastjson来解析，混淆时候需要加入以下类似的规则，不混淆Province、City等实体类。 ``` -keepattributes InnerClasses,Signature -keepattributes Annotation

-keep class cn.qqtheme.framework.entity.** { *;} ```

Sample （更多用法详见示例项目）

各种设置方法：

java
picker.setXXX(...);

如：
设置选项偏移量，可用来要设置显示的条目数，范围为1-5，1显示3行、2显示5行、3显示7行……

java
picker.setOffset(...);

设置启用循环

java
picker.setCycleDisable(false);

设置每项的高度，范围为2-4

java
picker.setLineSpaceMultiplier(...);
picker.setItemHeight(...);

设置文字颜色、字号、字体等

java
picker.setTextColor(...);
picker.setTextSize(...);
picker.setTextPadding(...);
picker.setTextSizeAutoFit(...);
picker.setTypeface(...);

设置单位标签

java
picker.setLabel(...);
picker.setOnlyShowCenterLabel(...))

设置默认选中项

java
picker.setSelectedItem(...);
picker.setSelectedIndex(...);

设置滚轮项填充宽度，分割线最长

java
picker.setUseWeight(true);
picker.setDividerRatio(WheelView.DividerConfig.FILL);

设置触摸弹窗外面是否自动关闭

java
picker.setCanceledOnTouchOutside(...);

设置分隔线配置项，设置null将隐藏分割线及阴影

java
picker.setDividerConfig(...);
picker.setDividerColor(...);
picker.setDividerRatio(...);
picker.setDividerVisible(...);

设置内容边距

java
picker.setContentPadding(...);

设置选中项背景色

java
picker.setShadowColor(...)

自定义顶部及底部视图

java
picker.setHeaderView(...);
picker.setFooterView(...);

获得内容视图（不要调用picker.show()方法），可以将其加入到其他容器视图（如自定义的Dialog的视图）中

java
picker.getContentView();

获得按钮视图（需要先调用picker.show()方法），可以调用该视图相关方法，如setVisibility()

java
picker.getCancelButton();
picker.getSubmitButton();

自定义选择器示例：

java
        CustomHeaderAndFooterPicker picker = new CustomHeaderAndFooterPicker(this);
        picker.setOnOptionPickListener(new OptionPicker.OnOptionPickListener() {
            @Override
            public void onOptionPicked(int position, String option) {
                showToast(option);
            }
        });
        picker.show();

核心滚轮控件为WheelView，可以参照SinglePicker、DateTimePicker及LinkagePicker自行扩展。

Screenshots

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

Thanks

基于View的WheelView
基于ListView的WheelView
基于ScrollView的WheelView

License

MIT License

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.