API
Download
安卓选择器类库,包括日期选择器、时间选择器、单项选择器、城市选择器、颜色选择器、文件选择器、目录选择器、数字选择器、星座选择器、生肖选择器等,可自定义顶部及底部界面,可自定义窗口动画。
欢迎大伙儿在Issues提交你的意见或建议。
欢迎Fork & Pull requests贡献您的代码。查看更新日志。
"app"是测试用例;"library"包括WheelPicker、ColorPicker、FilePicker, WheelPicker包括DateTimePicker、OptionPicker、LinkagePicker、AddressPicker、NumberPicker等, 可下载本项目手动进行源代码集成,导入"library"下的相关module(记得将module下的build.gradle修改为以下内容,否则可能会报错找不到BuildToolsVersion):
apply plugin: 'com.android.library' android { compileSdkVersion 23 buildToolsVersion 23.0.1 defaultConfig { minSdkVersion 14 targetSdkVersion 22 } } dependencies { compile project(':Common') //Common模块不需要加此句 }
然后依赖(WheelPicker、FilePicker及ColorPicker是独立的,需要用哪个就compile哪个):
dependencies {
compile project(':WheelPicker')
compile project(':FilePicker')
compile project(':ColorPicker')
}也可以直接远程加载jcenter里的(latest.release为最新版,也可以参照此处指定具体的版本号):
dependencies {
compile 'cn.qqtheme.framework:WheelPicker:latest.release'
compile 'cn.qqtheme.framework:FilePicker:latest.release'
compile 'cn.qqtheme.framework:ColorPicker:latest.release'
}注: 本项目使用gradle来构建,迁移到Eclipse比较麻烦,建议换为Android Studio或Intellij IDEA。 由于地址选择器使用了fastjson来解析,混淆时候需要加入以下类似的规则,不混淆Province、City等实体类。
-keep class cn.qqtheme.framework.entity.** { *;}
-keep class cn.qqtheme.framework.picker.AddressPicker$* { *;}
推荐使用ViewAnimator这个动画库来实现:
dependencies {
compile 'com.github.florent37:viewanimator:1.0.3'
}ViewAnimator.animate(picker.getRootView()) .slideBottomIn() .interpolator(new AccelerateInterpolator()) .start();
或者使用XML定义动画:
<resources> <style name="Animation.CustomPopup" parent="@android:style/Animation"> <item name="android:windowEnterAnimation">@anim/popup_in</item> <item name="android:windowExitAnimation">@anim/popup_out</item> </style> </resources>
picker.setAnimationStyle(R.style.Animation_CustomPopup);
添加自己的类,继承自现有的选择器,覆盖makeHeaderView、makeFooterView、onSubmit、onCancel,在确定选择时调用onSubmit, 取消选择时调用onCancel。详见示例:CustomHeaderAndFooterPicker.java。
public class CustomHeaderAndFooterPicker extends OptionPicker { @Nullable @Override protected View makeHeaderView() { return null;//顶部视图 } @Nullable @Override protected View makeFooterView() { return null;//底部视图 } @Override public void onSubmit() { super.onSubmit();//点击确定 } @Override protected void onCancel() { super.onCancel();//点击取消 } }
日期选择器:
DatePicker picker = new DatePicker(this, DatePicker.YEAR_MONTH_DAY); picker.setRange(1990, 2015);//年份范围 picker.setOnDatePickListener(new DatePicker.OnYearMonthDayPickListener() { @Override public void onDatePicked(String year, String month, String day) { showToast(year + "-" + month + "-" + day); } }); picker.show();
时间选择器:
//默认选中当前时间 TimePicker picker = new TimePicker(this, TimePicker.HOUR_OF_DAY); picker.setTopLineVisible(false); picker.setOnTimePickListener(new TimePicker.OnTimePickListener() { @Override public void onTimePicked(String hour, String minute) { showToast(hour + ":" + minute); } }); picker.show();
单项选择器(可用于性别、学历、职业、星座等选择):
OptionPicker picker = new OptionPicker(this, new String[]{ "第一项", "第二项", "这是一个很长很长很长很长很长很长很长很长很长的很长很长的很长很长的项" }); picker.setOffset(2); picker.setSelectedIndex(1); picker.setTextSize(11); picker.setOnOptionPickListener(new OptionPicker.OnOptionPickListener() { @Override public void onOptionPicked(String option) { showToast(option); } }); picker.show();
数字选择器(可用于身高、体重、年龄等选择):
NumberPicker picker = new NumberPicker(this); picker.setOffset(2);//偏移量 picker.setRange(145, 200);//数字范围 picker.setSelectedItem(172); picker.setLabel("厘米"); picker.setOnOptionPickListener(new OptionPicker.OnOptionPickListener() { @Override public void onOptionPicked(String option) { showToast(option); } }); picker.show();
二三级联动选择器(参见地址选择器)
地址选择器(含省级、地级、县级):
ArrayList<AddressPicker.Province> data = new ArrayList<AddressPicker.Province>(); String json = AssetsUtils.readText(this, "city.json"); data.addAll(JSON.parseArray(json, AddressPicker.Province.class)); AddressPicker picker = new AddressPicker(this, result); picker.setSelectedItem("贵州", "贵阳", "花溪"); //picker.setHideProvince(true);//加上此句举将只显示地级及县级 //picker.setHideCounty(true);//加上此句举将只显示省级及地级 picker.setOnAddressPickListener(new AddressPicker.OnAddressPickListener() { @Override public void onAddressPicked(String province, String city, String county) { showToast(province + city + county); } }); picker.show();
星座选择器:
OptionPicker picker = new OptionPicker(this, new String[]{ "水瓶", "双鱼", "白羊", "金牛", "双子", "巨蟹", "狮子", "处女", "天秤", "天蝎", "射手", "摩羯", }); picker.setLabel("座"); picker.setTopBackgroundColor(0xFFEEEEEE); picker.setTopLineColor(0xFFEE0000); picker.setCancelTextColor(0xFF33B5E5); picker.setSubmitTextColor(0xFF33B5E5); picker.setTextColor(0xFFFF0000, 0xFF999999); picker.setLineColor(0xFFEE0000); picker.setSelectedItem("射手"); picker.setOnOptionPickListener(new OptionPicker.OnOptionPickListener() { @Override public void onOptionPicked(String option) { showToast(option); } }); picker.show();
颜色选择器:
ColorPicker picker = new ColorPicker(this); picker.setInitColor(0xFFDD00DD); picker.setOnColorPickListener(new ColorPicker.OnColorPickListener() { @Override public void onColorPicked(int pickedColor) { showToast(ConvertUtils.toColorString(pickedColor)); } }); picker.show();
文件选择器(需要权限android.permission.READ_EXTERNAL_STORAGE):
FilePicker picker = new FilePicker(this, FilePicker.FILE); picker.setShowHideDir(false); picker.setRootPath(StorageUtils.getRootPath(this) + "Download/"); //picker.setAllowExtensions(new String[]{".apk"}); picker.setOnFilePickListener(new FilePicker.OnFilePickListener() { @Override public void onFilePicked(String currentPath) { showToast(currentPath); } }); picker.show();
目录选择器(需要权限android.permission.READ_EXTERNAL_STORAGE):
FilePicker picker = new FilePicker(this, FilePicker.DIRECTORY); picker.setOnFilePickListener(new FilePicker.OnFilePickListener() { @Override public void onFilePicked(String currentPath) { showToast(currentPath); } }); picker.show();
库项目修改了使用以下项目:
https://github.com/wangjiegulu/WheelView
https://github.com/jbruchanov/AndroidColorPicker
自定义选择器效果图
日期选择器效果图
时间选择器效果图
单项选择器效果图
地址选择器效果图
地址选择器效果图
数字选择器效果图
星座选择器效果图
颜色选择器效果图
文件选择器效果图
目录选择器效果图
