Skip to content

itrenjunhua/FlowLayout

Repository files navigation

FlowLayout 流式布局

Android 流式布局控件,实现自动换行,操出范围可以滑动功能,未使用控件复用功能,所以不应该有太多的子控件

主要包含功能:

  • 流式布局,自动换行
  • 使用Adapter的形势注入子控件
  • 设置子控件之间的间距(水平方向和竖直方向)
  • 竖直方向超出高度可以滑动
  • 给子控件设置点击监听
  • 设置可显示的最大行数,并提供方法判断是否当前所有的子控件都显示完成
  • 可以设置行内水平方向上对齐方式(居左对齐、居右对齐、两端对齐/左右对齐、居中对齐)
  • 提供自动滚动到顶部、滚动到底部、滚动到指定位置和滚动到指定行方法

效果图

使用

  1. 在布局中使用控件 FlowLayout.java 完整代码

     <com.renj.flowlayout.FlowLayout
             android:id="@+id/flow_layout"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:layout_marginTop="8dp"
             android:background="@color/colorAccent"
             android:paddingStart="12dp"
             android:paddingTop="8dp"
             android:paddingEnd="8dp"
             android:paddingBottom="12dp"
             app:flow_horizontal_gravity="right"
             app:flow_horizontal_spacing="6dp"
             app:flow_vertical_spacing="6dp" />
    
  2. 继承 FlowLayoutAdapter ,重写相关方法

FlowLayoutAdapter.java 完整代码

MainFlowLayoutAdapter.java 完整代码

	public class MainFlowLayoutAdapter extends FlowLayoutAdapter {
	    private List<String> dataList;
	    private int mCheckedPosition = -1;

	    public MainFlowLayoutAdapter(List<String> datas) {
		this.dataList = datas;
	    }

	    @Override
	    protected View createView(Context context, FlowLayout flowLayout, int position) {
		TextView textView = new TextView(context);
		textView.setTextSize(16);
		textView.setTextColor(context.getResources().getColor(R.color.color_text_grey));
		textView.setBackgroundResource(R.drawable.shape_text_bg);
		textView.setPadding(16, 6, 16, 6);
			textView.setText(dataList.get(position));
		return textView;
	    }

	    @Override
	    public int getItemCount() {
		return dataList == null ? 0 : dataList.size();
	    }

	    @Override
	    public Object getItem(int position) {
		if (ListUtils.isEmpty(dataList)) return null;
		return dataList.get(position);
	    }
	}
  1. FlowLayout 控件设置Adapter 完整使用代码

     flowLayout.setAdapter(new MainFlowLayoutAdapter(DataUtils.getDataList(30)));
    

其他属性设置

代码设置

  • setMaxRowCount(int maxRowCount):设置最大显示行数,maxRowCount:最大显示行数 小于0表示全部显示

  • setHorizontalGravity(int horizontalGravity):设置水平方向控件对齐方式,默认居左对齐,取值:

    • FlowLayout.HORIZONTAL_GRAVITY_LEFT :居左对齐,默认
    • FlowLayout.HORIZONTAL_GRAVITY_RIGHT : 居右对齐
    • FlowLayout.HORIZONTAL_GRAVITY_LEFT_RIGHT : 左右对齐/两端对齐
    • FlowLayout.HORIZONTAL_GRAVITY_CENTER : 居中对齐
  • setSpacing(int horizontalSpacing, int verticalSpacing):设置子控件之间的间距

  • scrollToTop(boolean animation):滚动到顶部,参数 true:使用动画滚动 false:不使用动画

  • scrollToBottom(boolean animation):滚动到底部,参数 true:使用动画滚动 false:不使用动画

  • scrollToPosition(int position, boolean animation):滚动到指定位置,参数 animation: true:使用动画滚动 false:不使用动画

  • scrollToRowNumber(int rowNumber, boolean animation):滚动到指定行数,参数 animation: true:使用动画滚动 false:不使用动画

  • setOnChildLayoutFinishListener(OnChildLayoutFinishListener onChildLayoutFinishListener):设置子控件布局完成监听

  • setOnItemClickListener(OnItemClickListener onItemClickListener):设置子控件点击监听

  • isChildViewAllShow():是否所有的子控件都显示了,需要在 setOnChildLayoutFinishListener(OnChildLayoutFinishListener) 回调中调用保证结果的正确

  • getShowRowCount():获取显示的行数,需要在 setOnChildLayoutFinishListener(OnChildLayoutFinishListener) 回调中调用保证结果的正确

      // 设置子控件布局完成监听,在回调中调用 getShowRowCount() 和 isChildViewAllShow() 方法
      private void setFlowLayoutFinishListener() {
          flowLayout.setOnChildLayoutFinishListener((flowLayout, showChildCount) -> {
              Logger.i("子控件布局完成: 显示行数: " + flowLayout.getShowRowCount() + " ;子控件总数:"
                      + flowLayoutAdapter.getItemCount() + " ;显示子控件数: " + showChildCount
                      + " ;全部子控件是否显示完成: " + flowLayout.isChildViewAllShow());
          });
      }
    

属性控制

<declare-styleable name="FlowLayout">
    <!-- 最大显示行数 -->
    <attr name="flow_max_row_count" format="integer" />
    <!-- 每一行水平方向对齐方式 -->
    <attr name="flow_horizontal_gravity" format="enum">
        <!-- 每一行水平方向对齐方式:左对齐,默认 -->
        <enum name="left" value="0" />
        <!-- 每一行水平方向对齐方式:右对齐 -->
        <enum name="right" value="1" />
        <!-- 每一行水平方向对齐方式:左右对齐 -->
        <enum name="left_right" value="2" />
        <!-- 每一行水平方向对齐方式:居中对齐 -->
        <enum name="center" value="3" />
    </attr>
    <!-- 水平方向间距 -->
    <attr name="flow_horizontal_spacing" format="dimension" />
    <!-- 竖直方向间距 -->
    <attr name="flow_vertical_spacing" format="dimension" />
</declare-styleable>

About

可滚动和设置对齐方式的流式布局控件

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages