一个优雅的Android流布局,支持均匀分布自动间距,支持展开、收缩功能,并且可以约束展开时的行数与收缩时的行数

一个优雅的Android的流布局,支持均匀分布自动间距,支持展开、收缩功能,并且可以约束展开时的行数与收缩时的行数。

感谢nex3z/FlowLayout,本项目是在该项目的基础上进行扩展开发。

集成效果

1.集成方式:

allprojects {
    repositories {
        ...
        maven { url 'https://www.jitpack.io' }
    }
}
 implementation 'com.github.Arcns:fast-flow-layout:1.0.3'

2.使用方式

  • (1)不需要展开、收缩功能的场景
// 你的布局文件
 <com.arc.fast.view.FastFlowLayout
        android:id="@+id/flow1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:fastFlowLayout_childSpacing="auto" // 均匀分布自动间距
        app:fastFlowLayout_minChildSpacing="12dp" /> // 自动间距时的最小间距
// 你的代码文件
val data = arrayListOf<String>("数据1","数据2","数据3") // 模拟数据,数据类型无限制
flow1.adapter = FastFlowAdapter(
    layoutRes = R.layout.your_item_layout, // 你的流布局的item布局文件
    data = data, // 绑定流布局的数据
    convert = { layout, item, position ->
        // 把数据填充到item布局中
        val text = layout.findViewById<TextView>(R.id.text)
        tvTag.text = item
    },
    onItemClick = { layout, item, position ->
        // item点击回调
    }
)
  • (2)需要展开、收缩功能的场景
// 你的布局文件
 <com.arc.fast.view.FastFlowLayout
        android:id="@+id/flow2"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:fastFlowLayout_childSpacing="12dp" // item的横向间距
        app:fastFlowLayout_rowSpacing="12dp" // item的纵向间距
        app:fastFlowLayout_expandRows="4" // 开展时显示的行数
        app:fastFlowLayout_shrinkRows="2" /> // 收缩时显示的行数
// 你的代码文件
val data = arrayListOf<String>("数据1","数据2","数据3") // 模拟数据,数据类型无限制
flow2.adapter = FastFlowAdapter(
    layoutRes = R.layout.your_item_layout, // 你的流布局的item布局文件
    data = data, // 绑定流布局的数据
    convert = { layout, item, position ->
        // 把数据填充到item布局中
        val text = layout.findViewById<TextView>(R.id.text)
        tvTag.text = item
    },
    onItemClick = { layout, item, position ->
        // item点击回调
    },
    expandRes = R.layout.your_item_layout, // 展开收缩item的布局文件
    onExpand = { expand, isExpand ->
        // 展开/收缩前的回调,你可以在此处修改展开收缩item的布局文件
        val text = expand.findViewById<TextView>(R.id.text)
        tvTag.text = if (isExpand) "收缩" else "展开"
        false
    }
)

3.FastFlowLayout支持的参数

参数 说明 类型 默认值
fastFlowLayout_flow 是否为流布局,如果不是流布局将在一行中显示 boolean true
fastFlowLayout_childSpacing 流布局item的间距 dimension/auto 0
fastFlowLayout_minChildSpacing 流布局item的最小间距 dimension 0
fastFlowLayout_childSpacingForLastRow 流布局最后一行item的间距 dimension/auto/align 0
fastFlowLayout_rowSpacing 流布局每行的间距 dimension 0
fastFlowLayout_rtl true标识右到左布局,false从左到右布局 boolean false
fastFlowLayout_enableShrinkView 展开后是否显示收缩item boolean true
fastFlowLayout_expandRows 展开后的行数 integer Int.MAX_VALUE
fastFlowLayout_shrinkRows 收缩后的行数 integer Int.MAX_VALUE

auto表示流布局item的间距根据每行最多可放置的item进行自动计算,使流布局item均匀放置。

align表示流布局item间距与上一行的间距保持一致。若只有一行,则忽略该值并使用auto进行计算。

项目地址:
https://github.com/Arcns/fast-flow-layout

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容