自定义的多宫格布局

FlexGridLayout

自定义的多宫格布局

目的:

之前有个需求需要用到仿IOS相册展示图片的布局方式,将图片以不同大小布局在一起,不像其他相册应用都是使用对称列表来展示图片,没有给人惊喜乃至于惊艳的感觉,于是我在网上搜了个遍感觉并没有符合要求的解决方案,所以我为了通过多宫格显示图片来体现不对称之美,设计了一个比较简易的框架,能够支持开发者自定义每组图片的布局。

效果图:

三宫格布局
七宫格布局

导入

项目 build.gradle:

buildscript {
    repositories {
        ...
        mavenCentral()
    }
    ...
}

需要导入的模块 build.gradle:

implementation 'io.github.moke926:flexgrid:1.0.0'

怎么使用

每一组多宫格布局都是由多个小矩形拼接而成。

FlexChild

小矩形是这个组件的最小单位View,你可以自定义这些小矩形,只要你实现 FlexGrid 这个接口就行, 比如内部默认已经写好的 FlexView :

class FlexView @JvmOverloads constructor(
    context: Context, attrs: AttributeSet? = null, defStyleAttr: Int = 0) :
    AppCompatImageView(context, attrs, defStyleAttr), FlexChild {

    private var mStartCoordinate = Pair(0, 0)
    private var mEndCoordinate = Pair(0, 0)

    override fun setCoordinate(startCoordinate: Pair<Int, Int>, endCoordinate: Pair<Int, Int>) {
        mStartCoordinate = startCoordinate
        mEndCoordinate = endCoordinate
    }
    ...
}

其中 setCoordinate(...)这个方法必须实现,用来传入代表该小矩形的左上角坐标和右下角坐标,这两个坐标在一起可以描述这个小矩形一组多宫格布局中的位置和大小。这两个坐标并不是真实的view的坐标值,而是一组虚拟坐标,举个例子,如下图所示:

最常见的九宫格布局坐标分布图

FlexGridGroup内部就可以通过对每个实现了FlexGrid接口的对象读取他们的左上角坐标和右下角坐标来进行测量和布局。

FlexGridGrop

FlexGridGroup组件扮演着容纳一组排列好的小矩形的容器角色即ViewGroup,通过读取其中包含的小矩形虚拟坐标来绘制出一组多宫格布局。
你在实例化FlexGridGroup的时候需要调用addGrids(list: List<FlexChild>)setAdapter(adapter: FlexAdapter<*>)

addGrid
你需要传入一组实现了FlexChild接口的View对象用来描述这一个多宫格布局的基本框架, 而这些对象请确定都已经设定好了左上角坐标和右下角坐标,当然你也可以传入非View,不过我会在内部根据坐标转成默认的FlexView对象。

setAdapter
FlexGridLayout采取了适配器模式,你需要自定义一个adapter继承FlexViewGroup.FlexAdapter,并指定Adapter的泛型为你的数据类型,如sample用例中的TestFlexAdapter

class TestFlexAdapter: FlexGridGroup.FlexAdapter<FlexItem>() {
    override fun bind(data: FlexItem, flexChild: FlexChild) {
        val view = flexChild as? FlexView
        if(view != null) {
            ...
        }
    }
}

你可以通过重写的bind(...)方法中获得一个数据和对应位置的 FlexChild 对象,之后你就可以为所欲为了。

FlexGridGroup 拥有自定义属性,目前的属性如下:

<declare-styleable name="FlexGridGroup">
        <attr name="horizontalGap" format="dimension"/>
        <attr name="verticalGap" format="dimension"/>
        <attr name="standUnitSize" format="dimension"/>
</declare-styleable>

horizontalGap :
左右两个小矩形水平方向上的间隔

verticalGap
上下两个小矩形竖直方向上的间隔

standUnitSize
特别情况下,你可以指定这个值来设置单位矩形大小。比如, 左上角坐标为 ( 0 , 0 )且右下角坐标为 ( 0 , 1 )的矩形,包含了2个单位矩形, 左上角坐标为 ( 0 , 0 )且右下角坐标为 ( 2 , 2 )的矩形,包含了9个单位矩形,这是最基本的九宫格结构。

当然,具体的使用方法请参考用例模块 example

未来开发计划:

目前下阶段的任务是:

  • item变化的动画

项目的github地址是:FlexGridLayout

欢迎朋友一起来讨论和完善此框架。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,651评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,468评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,931评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,218评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,234评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,198评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,084评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,926评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,341评论 1 311
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,563评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,731评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,430评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,036评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,676评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,829评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,743评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,629评论 2 354

推荐阅读更多精彩内容