/JKCardLayout

高仿即刻APP探索页卡片布局拖拽、卡片前进、回退和下拉效果,采用RecyclerView和自定义LayoutManager实现

Primary LanguageJava

重要提示:该交互flutter实现已经开源,快来围观:https://github.com/HitenDev/FlutterDragCard

----------以下正文----------

JKCardLayout

本项目使用RecyclerView和自定义LayoutManager等方法实现即刻App探索页交互,支持卡片拖拽,卡片回退栈管理,下拉展示菜单等功能;欢迎大家点赞或者吐槽。

代码大部分使用Kotlin语言编写,假装娴熟,如有使用不当还请各路大神指点。

下载Demo

下载地址:https://www.pgyer.com/yZ2L

效果展示

视频

https://youtu.be/GY_YVJGgKtk

图片

如何使用

implementation 'me.hiten:jkcardlayout:0.1.1'

卡片布局辅助类CardLayoutHelper

绑定RecyclerView

mCardLayoutHelper = CardLayoutHelper<T>()
mCardLayoutHelper.attachToRecyclerView(recycler_view)

绑定数据源List

mCardLayoutHelper.bindDataSource(object : CardLayoutHelper.BindDataSource<T> {
     override fun bind(): List<T> {
         return list
     }
 })

绑定数据源采用回调接口形式,需要返回绑定的RecyclerView对应Adapter下的数据源List

卡片参数配置

val config = CardLayoutHelper.Config()
        .setCardCount(2)
        .setMaxRotation(20f)
        .setOffset(8.dp)
        .setSwipeThreshold(0.2f)
        .setDuration(200)

mCardLayoutHelper.setConfig(config)

CardLayoutHelper.Config接受参数配置,主要参数含义:

  • cardCount //卡片布局最多包含卡片个数,默认是2个
  • offset //卡片之间的偏移量,单位是像素
  • duration //卡片动画执行时间
  • swipeThreshold //拖拽卡片触发移除的阈值
  • maxRotation //拖拽过程中最大旋转角度(角度制)

行为操作(Back和Next)

//check and doNext
if (mCardLayoutHelper.canNext()) {
    mCardLayoutHelper.doNext()
}
//check and doBack
if (mCardLayoutHelper.canBack()){
    mCardLayoutHelper.doBack()
}

//check noBack
if (mCardLayoutHelper.noBack()){
    super.onBackPressed()
}

结合即刻案例,提供了Back和Next两种操作,使用前建议调用canXXX()进行判断

回调监听

mCardLayoutHelper.setOnCardLayoutListener(object :OnCardLayoutListener{
    override fun onSwipe(dx: Float, dy: Float) {
        Log.d("onStateChanged","dx:$dx dy:$dy")
    }
    override fun onStateChanged(state: CardLayoutHelper.State) {
        Log.d("onStateChanged",state.name)
    }
})
  • onSwipe(dx: Float, dy: Float) //卡片滑动距离回调
  • onStateChanged(state: CardLayoutHelper.State)//卡片状态监听,State详解
  • State.IDLE //默认状态,无拖拽和动画执行
  • State.SWIPE //手指拖动状态
  • State.BACK_ANIM //Back动画执行中,包含两种情况(释放手势卡片缓慢回到默认位置过程、调用back方法执行动画)
  • State.LEAVE_ANIM //LEAVE动画执行中,包括两种情况(释放手势卡片缓慢移除布局过程、调用next方法执行动画)

仿即刻下拉手势布局:PullDownLayout

基本功能设置

//设置阻尼
pull_down_layout.setDragRatio(0.6f)
//设置视觉差系数
pull_down_layout.setParallaxRatio(1.1f)
//设置动画时长
pull_down_layout.setDuration(200)

注意PullDownLayout类不在library中,如果需要使用的话,建议您clone一份代码改巴改巴

声明

本项目是个人作品,仅用作技术学习和开源交流,涉及到即刻APP相关的接口数据和图片资源禁止用于任何商业用途;如有疑问,请联系我。