一、项目概况
我们都知道RadioGroup可以实现选择框,但它有一个局限性,由于它是继承自LinearLayout的,所以只能有一个方向,横向或者纵向;但有时候仅一行的RadioGroup并不能满足实际的需求,比如在一行的宽度下显示不完所有的选项,设计上又不允许左右滑动,这时候RadioGroup就不能满足这样的功能设计了;基于此,我写了这个MultiLineRadioGroup并且开源出来;
1、程序界面效果图
2、功能接口
在Api开发上,能够用到的功能及我能想到的,基本都已经添加完毕;具体如下:
- child选项添加,删除
- child选项选中,取消选中
- child对齐方式(左|中|右)
- child行间距,左右间距
- 设置选择模式(单选|多选)
- 获取已选选项
- child选择状态的监听回调查
3、Demo链接地址
https://github.com/a284628487/MultiLineRadioGroup
二、项目分析
1、基于上面的功能设计,为了设计方便,添加了一些自定义属性;
<declare-styleable name="MultiLineRadioGroup">
<attr name="child_margin_horizontal" format="dimension" />
<attr name="child_margin_vertical" format="dimension" />
<attr name="child_layout" format="integer" />
<attr name="child_count" format="integer" />
<attr name="child_values" format="integer" />
<attr name="single_choice" format="boolean" />
<attr name="gravity" format="integer" />
</declare-styleable>
上面的几个自定义属性分别表示
- child水平间距
- child上下间距
- child对应的layout布局文件(后面会讲到,此属性必须配置)
- 初始元素个数
- 初始元素值列表
- 选择模式(单选|多选)
- child对齐方式
2、在layout中使用MultiLineRadioGroup
(1)、定义一个包含MultiLineRadioGroup的xml文件
<org.ccflying.MultiLineRadioGroup
android:id="@+id/content"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:child_layout="@layout/child"
app:child_margin_horizontal="6.0dip"
app:child_margin_vertical="2.0dip"
app:child_values="@array/childvalues"
app:single_choice="true" >
</org.ccflying.MultiLineRadioGroup>
(2)、定义一个根节点为CheckBox的layout文件,并把该文件id设置到MultiLineRadioGroup的child_layout属性中(注:该属性必须设置)
<CheckBox xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@drawable/bg"
android:button="@null"
android:padding="8.0dip"
android:textColor="@color/text_color" >
</CheckBox>
在MultiLineRadiaGroup中,它的子child元素为CheckBox,所以,必须指定一个要布局为CheckBox的child_layout,这个CheckBox可以根据你的需求设置它的不同状态下的样式;
3、MultiLineRadioGroup 核心方法分析
(1)、onMeasure
@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
super.onMeasure(widthMeasureSpec, heightMeasureSpec);
childCount = getChildCount();
int flagX = 0, flagY = 0, sheight = 0;
if (childCount > 0) {
for (int i = 0; i < childCount; i++) {
View v = getChildAt(i);
measureChild(v, widthMeasureSpec, heightMeasureSpec);
int w = v.getMeasuredWidth() + childMarginHorizontal * 2
+ flagX + getPaddingLeft() + getPaddingRight();
if (w > getMeasuredWidth()) {
flagY++;
flagX = 0;
}
sheight = v.getMeasuredHeight();
flagX += v.getMeasuredWidth() + childMarginHorizontal * 2;
}
rowNumber = flagY;
}
int height = (flagY + 1) * (sheight + childMarginVertical)
+ childMarginVertical + getPaddingBottom() + getPaddingTop();
setMeasuredDimension(getMeasuredWidth(), height);
}
遍历所有的child,并且调用measureChild来对child进行宽高的测量,再通过对宽度的累加与getWidth的值进行比较来判断是否需要换行,并且对需要用到的行数进行记录;
(2)、onLayout
@Override
protected void onLayout(boolean changed, int l, int t, int r, int b) {
if (!changed && !forceLayout) {
Log.d("tag", "onLayout:unChanged");
return;
}
childCount = getChildCount();
int[] sX = new int[rowNumber + 1];
if (childCount > 0) {
if (gravity != LEFT) {
for (int i = 0; i < childCount; i++) {
View v = getChildAt(i);
int w = v.getMeasuredWidth() + childMarginHorizontal * 2
+ mX + getPaddingLeft() + getPaddingRight();
if (w > getWidth()) {
if (gravity == CENTER) {
sX[mY] = (getWidth() - mX) / 2;
} else { // right
sX[mY] = (getWidth() - mX);
}
mY++;
mX = 0;
}
mX += v.getMeasuredWidth() + childMarginHorizontal * 2;
if (i == childCount - 1) {
if (gravity == CENTER) {
sX[mY] = (getWidth() - mX) / 2;
} else { // right
sX[mY] = (getWidth() - mX);
}
}
}
mX = mY = 0;
}
for (int i = 0; i < childCount; i++) {
View v = getChildAt(i);
int w = v.getMeasuredWidth() + childMarginHorizontal * 2 + mX
+ getPaddingLeft() + getPaddingRight();
if (w > getWidth()) {
mY++;
mX = 0;
}
int startX = mX + childMarginHorizontal + getPaddingLeft()
+ sX[mY];
int startY = mY * v.getMeasuredHeight() + (mY + 1)
* childMarginVertical;
v.layout(startX, startY, startX + v.getMeasuredWidth(), startY
+ v.getMeasuredHeight());
mX += v.getMeasuredWidth() + childMarginHorizontal * 2;
}
}
mX = mY = 0;
forceLayout = false;
}
和onMeasure一样,onLayout方法也需要对child进行遍历,不过,在这里的遍历就不是进行测量了,而是对child进行摆放,摆放的时候就需要用到onMeasure方法里面所测量出的子元素的宽高等属性;
遍历可能会遍历两次,如果child对齐方式是非Left的情况下,第一次遍历计算出每行的空隙,然后根据对齐方式算出每行的第一个child的偏移left的距离,第二次遍历的时候,再根据之前算出的偏移距离对child进行layout;
(3)、其它方法
- append(String str) 附加一个child;
- insert(int position, String str) 往指定位置插入child;
- getCheckedValues()|getCheckedItems() 获取选中项;
- remove(int position) 删除指定位置的child;
- setItemChecked(int position) 选中指定位置的child;
- setGravigy(int gravity) 设置child对齐方式;
这些方法都是根据常用或者可能用到的方法来进行实现的,比较简单,就不再贴出代码,上面的Demo链接中都有;
Over!