jetpack组件---包含标签的滑动视图:ViewPager2

viewpager2是什么?

滑动视图允许您通过水平手指手势或滑动在同级屏幕(例如标签页)之间进行导航。此导航模式也称为“水平分页”。本主题介绍了如何创建具有滑动视图(以便在标签页之间切换)的标签页布局,以及如何显示标题条而不是标签页。

大部分app的首页都是底部带有导航图的可滑动的若干个视图组成的,像微信啊这些都是,这种页面使用viewPage2都可以很轻松的实现,另外一种实现方式是使用BottomNavigationView来实现,这种实现方式请参照Android Navigation Architecture Component 使用详解,但我觉得第二种实现方式更适用于同一个页面内fragment的跳转,同级别导航还是用viewpager2更好。

viewpager2的来源

viewpager2的前身是viewpager,谷歌推出viewpager2的原因就是为了去替代viewpager,至于原因好像是因为viewpager不能复用view,具体我也不知道,因为现在viewpager2已结很成熟的原因,我一直没接触viewpager。如果你需要将项目中viewpager变为viewpage2,请参考从 ViewPager 迁移到 ViewPager2。viewpager2的实现原理是recycleview,具体怎么实现的如果有必要我会试着去分析他的原理。

viewpager2的简单使用

我这里采用tablayout+viewpager2来实现顶部带有标签页的activity
至于什么是tablayout,请阅读Tablayout使用全解,一篇就够了(请注意和tablelayout区分开)
首先我们先创建一个fragment的通用类

class PageFragment : Fragment() {
    private var mColors: List<Int>? = null
    private var mPosition = 0
    override fun onCreate(@Nullable savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        if (arguments != null) {
            mColors = arguments!!.getSerializable(COLORS) as List<Int>?
            mPosition = arguments!!.getInt(POSITION)
        }
    }

    @Nullable
    override fun onCreateView(
        inflater: LayoutInflater,
        @Nullable container: ViewGroup?,
        @Nullable savedInstanceState: Bundle?
    ): View {
        return inflater.inflate(com.example.viewpager2demo.R.layout.item_page, container, false)
    }

    override fun onViewCreated(view: View, @Nullable savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        container.setBackgroundResource(mColors!![mPosition])
        tvTitle.text = "Item $mPosition"
    }

    companion object {
        private const val COLORS = "colors"
        private const val POSITION = "position"
        fun newInstance(colors: List<Int?>?, position: Int): PageFragment {
            val args = Bundle()
            args.putSerializable(COLORS, colors as ArrayList<Int?>?)
            args.putInt(POSITION, position)
            val fragment = PageFragment()
            fragment.arguments = args
            return fragment
        }
    }
}

需要注意的地方:

if (arguments != null) {
            mColors = arguments!!.getSerializable(COLORS) as List<Int>?
            mPosition = arguments!!.getInt(POSITION)
        }

这里是接收上一个fragment传过来的参数,具体传参是在

 fun newInstance(colors: List<Int?>?, position: Int): PageFragment {
            val args = Bundle()
            args.putSerializable(COLORS, colors as ArrayList<Int?>?)
            args.putInt(POSITION, position)
            val fragment = PageFragment()
            fragment.arguments = args
            return fragment
        }

传参方式也是由argument来传递,这一点和Navigation跳转传递参数是一样的。不清楚的可以看一下我的另一篇文章jetpack组件---导航框架:navigation

item_page.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/container"
    android:layout_height="match_parent">
    <TextView
        android:id="@+id/tvTitle"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"/>

</androidx.constraintlayout.widget.ConstraintLayout>

这里没什么好说的,就是一个fragment通用视图,加一个TextView区分不同的fragment,在实际开发中往往每个fragment都有不同的视图。

viewpager2最重要的一点是需要将此布局挂接到 FragmentStateAdapter
所以我们先创建一个类去继承并实现他的方法

internal class ViewPagerFragmentStateAdapter(val colors: List<Int>, fragmentActivity: FragmentActivity) : FragmentStateAdapter(fragmentActivity) {

    override fun getItemCount(): Int {
        return colors.size
    }

    override fun createFragment(position: Int): Fragment {
        return PageFragment.newInstance(colors, position)
    }
}

FragmentStateAdapter有两个必要方法,第一个是

 override fun getItemCount(): Int {
        return colors.size
    }

这就类似于recycleviewAdapter里的getItemCount()方法,在recycleview中它为了得到item的条数,在FragmentStateAdapter中它是为了得到滑动视图的个数

override fun createFragment(position: Int): Fragment {
        return PageFragment.newInstance(colors, position)
    }

这个方法是返回一个fragment,我们利用了PageFragment里面自己定义的全局方法newInstance()。

MainActivity:

class MainActivity : AppCompatActivity() {
    private val colors: MutableList<Int> = ArrayList()
    private var mAdapter: ViewPagerFragmentStateAdapter? = null
    override fun onCreate(@Nullable savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        mAdapter = ViewPagerFragmentStateAdapter(colors, this)
        viewpager2.adapter = mAdapter
        for (i in 0..3) {
            val tab: TabLayout.Tab = tablayout.newTab()
            tab.text = "TAB $i"
            tablayout.addTab(tab)
        }

        // 添加页签选中监听
        tablayout.addOnTabSelectedListener(object : OnTabSelectedListener {
            override fun onTabSelected(tab: TabLayout.Tab?) {
                viewpager2.currentItem = tab!!.position
            }

            override fun onTabUnselected(tab: TabLayout.Tab?) {

            }

            override fun onTabReselected(tab: TabLayout.Tab?) {

            }

        })
        /* tablayout.addOnTabSelectedListener(object : OnTabSelectedListener {
             override fun onTabSelected(tab: TabLayout.Tab) {
                 viewpager2.currentItem = tab.position
             }

             override fun onTabUnselected(tab: TabLayout.Tab) {}
             override fun onTabReselected(tab: TabLayout.Tab) {}
         })*/
        // 注册页面变化的回调接口
        viewpager2.registerOnPageChangeCallback(object : OnPageChangeCallback() {
            override fun onPageSelected(position: Int) {
                super.onPageSelected(position)
                tablayout.setScrollPosition(position, 0f, false)
            }
        })
    }

    init {
        colors.add(R.color.black)
        colors.add(R.color.material_on_primary_emphasis_high_type)
        colors.add(R.color.cardview_dark_background)
        colors.add(R.color.design_default_color_primary)
    }
}

这个就是主页面的代码了,我们分开看一下。

  init {
        colors.add(R.color.black)
        colors.add(R.color.material_on_primary_emphasis_high_type)
        colors.add(R.color.cardview_dark_background)
        colors.add(R.color.design_default_color_primary)
    }

最底部的init方法就是创建一个不同颜色的list集合作为创建fragment适配器的参数,从上面我们看到ViewPagerFragmentStateAdapter需要传入两个参数,第一个是一个颜色集合,实现不同的颜色以区分fragment,第二个参数是FragmentActivity,这是一个必传的参数。

mAdapter = ViewPagerFragmentStateAdapter(colors, this)
        viewpager2.adapter = mAdapter

这两句代码就是创建适配器,并指定适配器为布局代码里viewpager2的适配器。

 for (i in 0..3) {
            val tab: TabLayout.Tab = tablayout.newTab()
            tab.text = "TAB $i"
            tablayout.addTab(tab)
        }

这几句是给tablayout顶部标签命名,用for循环分别取名为TAB0---TAB3。注意:这里有一个使用tablayout的坑我直接写成

tablayout.addtab(Tablayout.Tab().text="Tab $i")

就会抛出空指针异常:Caused by: java.lang.NullPointerException: Attempt to invoke virtual method 'void com.google.android.material.tabs.TabLayout$TabView.setContentDescription(java.lang.CharSequence)' on a null object reference,不知道为啥,我看好像不只我一个人遇到这个问题,很多人都写过这个坑了,比如android tab选项卡使用及踩坑

 tablayout.addOnTabSelectedListener(object : OnTabSelectedListener {
            override fun onTabSelected(tab: TabLayout.Tab?) {
                viewpager2.currentItem = tab!!.position
            }

            override fun onTabUnselected(tab: TabLayout.Tab?) {

            }

            override fun onTabReselected(tab: TabLayout.Tab?) {

            }

        })

这是顶部tablayout的选中事件,我们需要点击顶部tablayout时切换fragment,所以需要在它的选中事件内部做

viewpager2.currentItem = tab!!.position

就是让选中的下标值等于viewpager2组件需要显示的视图下标值,这样就可以坐到切换fragment了。

 viewpager2.registerOnPageChangeCallback(object : OnPageChangeCallback() {
            override fun onPageSelected(position: Int) {
                super.onPageSelected(position)
                tablayout.setScrollPosition(position, 0f, false)
            }
        })

最后这个和上面的差不多,我们点击顶部tab是viewpager2里的fragment要变化,同样的,当viewpager2变化时顶部tab也要跟着变化,这段代码的作用就是这个。

好了,viewpager2差不多就是这些,放一张效果图:


1637830174791.gif

参考资料
从 ViewPager 迁移到 ViewPager2
使用 ViewPager2 创建包含标签的滑动视图
ViewPager2原理解析

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

推荐阅读更多精彩内容