android开发之wheel控件使用详解

时间:2022-04-25 22:32:21

出门在外生不起病呀,随便两盒药60多块钱。好吧,不废话了,今天我们来看看wheel控件的使用,这是GitHub上的一个开源控件,用起来十分方便,我们可以用它做许多事情,比如做一个自定义的datepicker,在一些电商App中,经常用它来做省市县三级联动,总之用途还是挺多的,我们今天就一起来看看怎么使用这个东东。

我们先来看看今天要做的一个效果图:

android开发之wheel控件使用详解

这是我们今天要做的效果图。下面就开始吧。

1.获得wheel

wheel是GitHub上的一个开源控件,我们可以直接在GitHub上下载,地址https://github.com/maarek/android-wheel,下载完成之后我们可以把里边的wheel文件直接当作一个library来使用,也可以把wheel里边的Java类和xml文件拷贝到我们的项目中使用。

2.使用方法

首先我们来看看主布局文件:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent" > <TextView
android:id="@+id/title"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:gravity="center"
android:text="请选择城市" /> <LinearLayout
android:id="@+id/content"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_below="@id/title"
android:background="@drawable/layout_bg"
android:orientation="horizontal" > <kankan.wheel.widget.WheelView
android:id="@+id/province_view"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1" >
</kankan.wheel.widget.WheelView> <kankan.wheel.widget.WheelView
android:id="@+id/city_view"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1" >
</kankan.wheel.widget.WheelView> <kankan.wheel.widget.WheelView
android:id="@+id/area_view"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1" >
</kankan.wheel.widget.WheelView>
</LinearLayout> <Button
android:id="@+id/confirm"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@id/content"
android:onClick="onClick"
android:text="确定" /> </RelativeLayout>

好了,在主布局文件中我们用到了三个WheelView,分别用来表示省市县,在MainActivity中,我们首先要拿到这三个控件:

provinceView = (WheelView) this.findViewById(R.id.province_view);
cityView = (WheelView) this.findViewById(R.id.city_view);
areaView = (WheelView) this.findViewById(R.id.area_view);

拿到之后,我们要使用ArrayWheelAdapter数据适配器来进行数据适配,这里需要两个参数,一个是上下文,另外一个是一个数组,这个数组就是我们要展示的内容,也就是说我们要把省、市、区县都存为数组的形式,但是考虑到一个省对应多个市,一个市对应多个区县,为了把省市县之间关联起来,我们还要用到一个Map集合,因此,我们设计的数据结构是这样的:

/**
* 省
*/
private String[] provinceArray;
/**
* 省-市
*/
private Map<String, String[]> citiesMap;
/**
* 市-区县
*/
private Map<String, String[]> areasMap;

第一个数组中存所有省的数据,第二个Map中存所有省对应的市的数据,第三个Map中存所有市对应的区县的数据,我们现在要给这是三个数据集赋值,先来看看我们的json数据格式:

[{"name":"北京","city":[{"name":"北京","area":["东城区","西城区","崇文区","宣武区"...]}]}.....]

我们的json数据就是这样一种格式,json数据存在assets文件夹中,下面我们看看怎么解析json数据并赋值给上面三个数据集:

	private void initJson() {
citiesMap = new HashMap<String, String[]>();
areasMap = new HashMap<String, String[]>();
InputStream is = null;
try {
StringBuffer sb = new StringBuffer();
is = getAssets().open("city.json");
int len = -1;
byte[] buf = new byte[1024];
while ((len = is.read(buf)) != -1) {
sb.append(new String(buf, 0, len, "gbk"));
}
JSONArray ja = new JSONArray(sb.toString());
provinceArray = new String[ja.length()];
String[] citiesArr = null;
for (int i = 0; i < provinceArray.length; i++) {
JSONObject jsonProvince = ja.getJSONObject(i);
provinceArray[i] = jsonProvince.getString("name");
JSONArray jsonCities = jsonProvince.getJSONArray("city");
citiesArr = new String[jsonCities.length()];
for (int j = 0; j < citiesArr.length; j++) {
JSONObject jsonCity = jsonCities.getJSONObject(j);
citiesArr[j] = jsonCity.getString("name");
JSONArray jsonAreas = jsonCity.getJSONArray("area");
String[] areaArr = new String[jsonAreas.length()];
for (int k = 0; k < jsonAreas.length(); k++) {
areaArr[k] = jsonAreas.getString(k);
}
areasMap.put(citiesArr[j], areaArr);
}
citiesMap.put(provinceArray[i], citiesArr);
} } catch (IOException e) {
e.printStackTrace();
} catch (JSONException e) {
e.printStackTrace();
} finally {
if (is != null) {
try {
is.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}

json解析技术上没有难点,这里的逻辑稍微有点复杂,用到了三个嵌套的for循环,大家慢慢琢磨一下其实也不难。好了,当数据集中都有数据之后,我们就可以给三个wheel设置Adapter了:

	private void initView() {
provinceView.setViewAdapter(new ArrayWheelAdapter<String>(
MainActivity.this, provinceArray));
// 默认显示北京直辖市里边的市(只有北京市)
cityView.setViewAdapter(new ArrayWheelAdapter<String>(
MainActivity.this, citiesMap.get("北京")));
// 默认显示北京市里边的区县
areaView.setViewAdapter(new ArrayWheelAdapter<String>(
MainActivity.this, areasMap.get("北京"))); // 默认显示第一项
provinceView.setCurrentItem(0);
// 默认显示第一项
cityView.setCurrentItem(0);
// 默认显示第一项
areaView.setCurrentItem(0);
// 页面上显示7项
provinceView.setVisibleItems(7);
cityView.setVisibleItems(7);
areaView.setVisibleItems(7);
// 添加滑动事件
provinceView.addChangingListener(this);
cityView.addChangingListener(this);
}

设置完Adapter之后我们还设置了一些缺省值,都很简单,大家直接看注释即可,我们这里设置了两个监听事件,我们看看:

@Override
public void onChanged(WheelView wheel, int oldValue, int newValue) {
if (wheel == provinceView) {
// 更新省的时候不仅要更新市同时也要更新区县
updateCity();
updateArea();
} else if (wheel == cityView) {
// 更新市的时候只用更新区县即可
updateArea();
}
} private void updateArea() {
// 获得当前显示的City的下标
int cityIndex = cityView.getCurrentItem();
// 获得当前显示的省的下标
int provinceIndex = provinceView.getCurrentItem();
// 获得当前显示的省的名字
String proviceName = provinceArray[provinceIndex];
// 获得当前显示的城市的名字
String currentName = citiesMap.get(proviceName)[cityIndex];
// 根据当前显示的城市的名字获得该城市下所有的区县
String[] areas = areasMap.get(currentName);
// 将新获得的数据设置给areaView
areaView.setViewAdapter(new ArrayWheelAdapter<String>(
MainActivity.this, areas));
// 默认显示第一项
areaView.setCurrentItem(0);
} private void updateCity() {
// 获得当前显示的省的下标
int currentIndex = provinceView.getCurrentItem();
// 获得当前显示的省的名称
String currentName = provinceArray[currentIndex];
// 根据当前显示的省的名称获得该省中所有的市
String[] cities = citiesMap.get(currentName);
// 将新获得的数据设置给cityView
cityView.setViewAdapter(new ArrayWheelAdapter<String>(
MainActivity.this, cities));
// 默认显示第一项
cityView.setCurrentItem(0);
}

几乎每行代码都有注释,我就不啰嗦了,最后我们再来看看点击事件:

	public void onClick(View v) {
// 获得当前显示的省的下标
int provinceIndex = provinceView.getCurrentItem();
// 获得当前显示的省的名称
String provinceName = provinceArray[provinceIndex];
// 获得当前显示的城市的下标
int cityIndex = cityView.getCurrentItem();
// 获得当前显示的城市的名称
String cityName = citiesMap.get(provinceName)[cityIndex];
// 获得当前显示的区县的下标
int areaIndex = areaView.getCurrentItem();
Toast.makeText(
this,
"您选择的地区是" + provinceArray[provinceIndex] + cityName
+ areasMap.get(cityName)[areaIndex], Toast.LENGTH_SHORT)
.show();
}

好了,到这里我们想要的功能基本上就实现了,但是我们可以看到,系统默认的样式略显丑陋,那我我们可以通过修改源码来获得我们想要的样式,首先上下的黑边看这里:

private int[] SHADOWS_COLORS = new int[] { 0xFF111111, 0x00AAAAAA,
0x00AAAAAA };

在WheelView.java文件中,这一行代码定义了上下黑边的颜色的变化,三个参数分别是起始颜色,过渡颜色以及结束时的颜色,那么我们可以通过修改这里的源码来去掉上下的黑边,还有中间那个透明的东东黑不拉叽的,我们想改,通过源码找到了这个文件wheel_val.xml:

<shape xmlns:android="http://schemas.android.com/apk/res/android">
<gradient
android:startColor="#70222222"
android:centerColor="#70222222"
android:endColor="#70EEEEEE"
android:angle="90" /> <stroke android:width="1dp" android:color="#70333333" />
</shape>

这里定义了中间那个透明条的样式,我们可以根据自己的需要进行修改。好了,这里的源码不多,也不难,大家可以自己去琢磨琢磨,关于wheel的介绍我们就说这么多。

本文Demo下载https://github.com/lenve/wheelTest