原创

苹果核 - vlayout使用说明(一)

前言

vlayout 的设计思路请参考Tangram 的基础 —— vlayout(Android)。框架已经开源,欢迎移步到 github 上指教。本文介绍 vlayout 的基本使用。

默认实现

默认通用布局实现,解耦所有的View和布局之间的关系: Linear, Grid, 吸顶, 浮动, 固定位置等。

  • LinearLayoutHelper: 线性布局

  • GridLayoutHelper: Grid布局, 支持横向的colspan

  • FixLayoutHelper: 固定布局,始终在屏幕固定位置显示

  • ScrollFixLayoutHelper: 固定布局,但之后当页面滑动到该图片区域才显示, 可以用来做返回顶部或其他书签等

  • FloatLayoutHelper: 浮动布局,可以固定显示在屏幕上,但用户可以拖拽其位置

  • ColumnLayoutHelper: 栏格布局,都布局在一排,可以配置不同列之间的宽度比值

  • SingleLayoutHelper: 通栏布局,只会显示一个组件View

  • OnePlusNLayoutHelper: 一拖N布局,可以配置1-5个子元素

  • StickyLayoutHelper: stikcy布局, 可以配置吸顶或者吸底

  • StaggeredGridLayoutHelper: 瀑布流布局,可配置间隔高度/宽度

上述默认实现里可以大致分为两类:一是非fix类型布局,像线性、Grid、栏格等,它们的特点是布局在整个页面流里,随页面滚动而滚动;另一类就是fix类型的布局,它们的子节点往往不随页面滚动而滚动。

所有除布局外的组件复用,VirtualLayout将用来管理大的模块布局组合,扩展了RecyclerView,使得同一RecyclerView内的组件可以复用,减少View的创建和销毁过程。

使用

版本请参考mvn repository上的最新版本(目前最新版本是1.0.1),最新的 aar 都会发布到 jcenter 和 MavenCentral 上,确保配置了这两个仓库源,然后引入aar依赖:

苹果核 - vlayout使用说明(一)

或者maven

苹果核 - vlayout使用说明(一)

初始化LayoutManager

苹果核 - vlayout使用说明(一)

设置回收复用池大小,(如果一屏内相同类型的 View 个数比较多,需要设置一个合适的大小,防止来回滚动时重新创建 View):

苹果核 - vlayout使用说明(一)

加载数据时有两种方式:

  • 一种是使用 DelegateAdapter, 可以像平常一样写继承自DelegateAdapter.Adapter的Adapter, 只比之前的Adapter需要多重载onCreateLayoutHelper方法。 其他的和默认Adapter一样。

苹果核 - vlayout使用说明(一)

  • 另一种是当业务有自定义的复杂需求的时候, 可以继承自VirtualLayoutAdapter, 实现自己的Adapter

苹果核 - vlayout使用说明(一)

在这种情况下,需要使用者注意在当LayoutHelpers的结构或者数据数量等会影响到布局的元素变化时,需要主动调用setLayoutHepers去更新布局模式。

Demo

苹果核 - vlayout使用说明(一)

详细代码参考:github

扩展布局

如果默认的布局实现满足不了,你的需求,可以注册自定义的LayoutHelper来实现布局逻辑。有三种基类可以供你使用:

BaseLayoutHelper:像LinearLayoutHelper、GridLayoutHelper等,内部View可以按行回收的布局,可直接继承此类,主要实现layoutViews()、computeAlignOffset()等方法。

AbstractFullFillLayoutHelper:有些布局内部的View 并不是从上至下排列的顺序,即 Adatper 里的数据顺序和物理视图顺序不一致,那么可能就不能按数据顺序布局和回收,需要一次性布局、一次性回收。主要实现layoutViews()等方法。可参考OnePlusNLayoutHelper。

FixAreaLayoutHelper:fix 类型的布局,子节点不随页面滚动而滚动。主要实现layoutViews()、beforeLayout()、afterLayout()等方法,可参考FixLayoutHelper。

相关文章

正文到此结束
Loading...