序章 第二幕 分页布局:ViewPager2

通过分页布局了解安卓的 View 框架

基础知识

什么是分页布局?

当你滑动 ViewPager2 组件时,软件会切换当前 ViewPager2 中显示的 Fragment,实现类似于滚动的翻页效果(也有很多其他效果),这就是分页布局。

在安卓开发中,Google 提供了 ViewPager2 和 ViewPager 两个分页布局组件,这篇博客主要讲解 ViewPager2 的使用方法。

需要注意的是:ViewPager 和 ViewPager2 都是 AndroidX 的一部分,所以需要注意添加依赖。

什么是 View

在 Android 中,View 是用户界面元素的基本构建块。每个 UI 组件在 Android 中都是 View 的子类。具体来说:

View

View 表示屏幕上的一个 UI 控件,可以绘制内容和处理用户交互。例如,Button、TextView 和 ImageView 等都是 View 的子类。

View Group

View Group 是 View 的子类,用于容纳和管理其中的 View。这些通常是布局元素,如 ConstraintLayout、LinearLayout 和 RelativeLayout 等。

在 xml 布局文件中添加 ViewPager2

以 Project 的方式打开资源管理

在 /Project/app/src/main/res/layout 文件夹下是你的项目的布局文件

打开你要添加分页布局的布局文件。

因为可视化编辑器的操作太人机了,我这里以 xml 内容为例讲解,这些属性在可视化编辑器也可以直接修改。

如果你的父布局是 ConstraintLayout:

1
2
3
4
5
6
7
8
9
10
11
<!-- emmmm,首先我的父布局是 ConstraintLayout -->
<!-- 所以要添加最后四行的约束条件 -->
<!-- 这里的约束条件就是全屏展示这个分页布局 -->
<androidx.viewpager2.widget.ViewPager2
android:id="@+id/viewpage"
android:layout_width="0dp"
android:layout_height="0dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />

在 android:id="@+id/viewpage" 这里的 @+id/viewpage 是这个组件的 资源 id,待会我们要在 Activity 中调用它。

注意:一定要准确设置或准确记录需要被 Activity 调用的 资源 id,且 id 不能重复,否则到时候调用成别的 View 会出现强制转换的报错(ERROR 级别)。

然后我们看 android:layout_width="0dp" 和 android:layout_height="0dp" 这里表示这个组件在布局中的宽和高。

在 ConstraintLayout 中,0dp 这个值是指在设置约束后铺满整个约束的条件,而大于 0dp 的值是指依附在一个约束条件下显示或在对应的两个约束以这个值作为宽高居中显示。

最后四行的 app:layout_constraint... 是 ConstraintLayout 约束条件,其中app在该xml布局文件的顶端有定义:xmlns:app="http://schemas.android.com/apk/res-auto"。

ConstraintLayout 可以理解为 RelativeLayout 的升级版,他提供了更多、更丰富、更智能的约束条件。

好了,现在我们了解了一些关于 View 和 Layout 的基础知识,那么现在我们就需要新建分页布局里要展示和切换的 Fragment 了。

创建要被分页布局展示的 Fragment

在 /Project/app/src/main/res 文件上右键,选择“新建(N)”,在弹出的窗口中选择“Fragment”,选择你喜欢的模板,需要几个分页就建几个。

在弹出的窗口中重命名。

注意:一定要准确设置或准确记录需要被 FragmentName,且不能重复,我们将在 Activity 中调用它。

在 Activity 中调用分页布局组件

在 onCreate() 方法中,setContentView() 方法下设置一个变量

请注意,在 Kotlin 中 val 用于设置可变变量,且如果编译器能够明白你设置的变量内容,你不用特地声明变量的类型。

1
val viewPager: ViewPager2 = findViewById(R.id.viewpage)

在上面这段代码中,我们设置了一个名为 viewPager 的变量,这个变量的类型为 ViewPager2。

然后我们调用了 findViewById() 方法,通过资源ID R.id.viewpage 找到我们刚刚 Layout 中添加的 ViewPager2 组件,并将其赋值给了刚刚设置的 viewPager 变量。

没错,在调用布局组件时我还是习惯性的声明的变量类型。(可恶的 Java)

好,那么如果不想声明变量类型该怎么写呢?

如果你直接删去类型,会发现编译器报错了。

这是因为 findViewById() 方法返回的是通用 View 类型,编译器无法自动推断出具体类型。(太不智能辣!)

但是,如果你使用Kotlin的扩展函数 findViewById<T>() ,那么就不需要显式声明类型了。

其实也算声明了,因为 T 标识一个泛型类型参数。

示例如下:

1
val viewPager = findViewById<ViewPager2>(R.id.viewpage)

这就是 Kotlin 的特性之一,简洁优雅,使得代码更加类型安全和可维护。

创建一个类管理 ViewPager2 中多个 Fragment 的适配器

首先创建一个类:

1
2
3
class ViewPagerAdapter(fragmentActivity: FragmentActivity):
FragmentStateAdapter(fragmentActivity){
}

其中:

声明类

在 class ViewPagerAdapter 里声明一个名为 ViewPagerAdapter 的类。

在 (fragmentActivity: FragmentActivity) 里 ViewPagerAdapter 类接受一个 FragmentActivity 对象作为参数。

在 FragmentStateAdapter(fragmentActivity) 里 ViewPagerAdapter 继承自 FragmentStateAdapter,并将 fragmentActivity 传递给父类的构造函数。

构造函数

构造函数是一种特殊的函数,用来在对象实例化的时候初始化对象的成员变量,构造函数必须与类名相同,并且不能有返回值(返回值类型也不能写void)。

初始化成员变量

1
2
3
4
private val fragments = listOf(
HomeFragment(),
UserFragment()
)

这里 private val fragments 定义了一个名为 fragments 的不可变的列表,其中包含了两个 Fragment 实例:HomeFragment 和 UserFragment。这是要在 viewPager 中显示的页面。

实现方法

1
2
override fun getItemCount(): Int = fragments.size
override fun createFragment(position: Int): Fragment = fragments[position]

这里 override fun getItemCount(): Int = fragments.size 重写了 FragmentStateAdapter 中的 getItemCount() 方法,通过返回 fragments 列表的大小获取即页面的数量。在这个例子中,返回值为2。

然后 override fun createFragment(position: Int): Fragment = fragments[position] 重写了 FragmentStateAdapter 中的 createFragment() 方法,根据提供的 position 参数返回对应的 Fragment 。在这个例子中,当 position 为 0 时,返回 HomeFragment;当 position 为 1 时,返回 UserFragment。

Override

在 Kotlin 中,override 关键字用于表示子类重写父类或接口中的方法。fun 是函数声明的关键字。所以,override fun 表示你正在重写父类或接口中的一个方法。

以下是一个简单的示例来说明这个概念:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
open class Animal {
open fun makeSound() {
println("金凡的最爱,MIUI的特色")
}
}

class Dog : Animal() {
override fun makeSound() {
println("汪汪汪!")
}
}

fun main() {
val myDog = Dog()
myDog.makeSound() // 输出“汪汪汪!”
}

在这个示例中:

Animal 类有一个可被重写的方法 makeSound(),它使用 open 关键字来允许子类重写它。

Dog 类继承了 Animal 类,并且使用 override 关键字来重写 makeSound 方法。

在 main 函数中,当我们调用 Dog 实例的 makeSound 方法时,会输出“汪汪汪!”,而不是输出“金凡的最爱,MIUI的特色”。

设置适配器

最后,在 onCreate() 方法中添加如下代码:

1
viewPager.adapter = ViewPagerAdapter(this)

其中 viewPager 是我们定义 ViewPager2 变量,表示你的滑动页面控件。

之后 adapter 是 ViewPager2 的一个属性,用于设置页面适配器。适配器负责为ViewPager2提供页面数据。

最后 ViewPagerAdapter(this) 是一个 ViewPagerAdapter 实例。this 在这里表示传入当前的 FragmentActivity 实例,传递给 ViewPagerAdapter 的构造函数。

运行

最后我们运行它,分页布局和里面展示的 Fragment 就能正常显示啦!

完整代码

***Activity.kt:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
package com.***.***

import android.os.Bundle
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentActivity
import androidx.viewpager2.adapter.FragmentStateAdapter
import androidx.viewpager2.widget.ViewPager2

class ***Activity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
enableEdgeToEdge()
setContentView(R.layout.activity_home)
val viewPager: ViewPager2 = findViewById(R.id.viewpage)
viewPager.adapter = ViewPagerAdapter(this)
}

class ViewPagerAdapter(fragmentActivity: FragmentActivity):
FragmentStateAdapter(fragmentActivity){
private val fragments = listOf(
HomeFragment(),
UserFragment()
)
override fun getItemCount(): Int = fragments.size
override fun createFragment(position: Int): Fragment = fragments[position]
}
}

activity_***.xml:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/background">

<androidx.viewpager2.widget.ViewPager2
android:id="@+id/viewpage"
android:layout_width="0dp"
android:layout_height="0dp"
app:layout_constraintBottom_toBottomOf="@+id/view"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />

<view
android:id="@+id/view"
class="net.center.blurview.ShapeBlurView"
android:layout_width="0dp"
android:layout_height="0dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="@+id/constraintLayout2"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="@+id/constraintLayout2" />

<androidx.constraintlayout.widget.ConstraintLayout
android:id="@+id/constraintLayout2"
android:layout_width="match_parent"
android:layout_height="0dp"
app:layout_constraintBottom_toBottomOf="parent"
tools:layout_editor_absoluteX="90dp">

<Button
android:id="@+id/home_button"
style="@style/Widget.Material3.Button"
android:layout_width="wrap_content"
android:layout_height="60dp"
android:layout_marginStart="60dp"
android:background="@android:color/transparent"
android:text="@string/home_page"
android:textColor="@color/bottom_bar_button"
android:textSize="11sp"
app:icon="@drawable/ic_home_page"
app:iconGravity="textTop"
app:iconPadding="8dp"
app:iconSize="20dp"
app:iconTint="@color/bottom_bar_button"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:rippleColor="@android:color/transparent"
app:strokeColor="@color/bottom_bar_button"
tools:ignore="TextContrastCheck" />

<Button
android:id="@+id/user_button"
android:layout_width="wrap_content"
android:layout_height="60dp"
android:layout_marginEnd="60dp"
android:background="@android:color/transparent"
android:text="@string/uesr_page"
android:textColor="@color/bottom_bar_button"
android:textSize="11sp"
app:icon="@drawable/ic_user_page"
app:iconGravity="textTop"
app:iconPadding="8dp"
app:iconSize="20dp"
app:iconTint="@color/bottom_bar_button"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintTop_toTopOf="parent"
tools:ignore="TextContrastCheck" />
</androidx.constraintlayout.widget.ConstraintLayout>

</androidx.constraintlayout.widget.ConstraintLayout>

结语

Kotlin 是一个简洁、安全的语言,伴随着 Compose 声明式 UI 的来临,安卓开发将会变得越来越简单!

单词表

单词 音标 词义
button /ˈbʌtn/ n. (机器的)按钮;纽扣;扣子;(尤指印有信息的)徽章
v. 扣…的纽扣;用纽扣扣上
constraint /kənˈstreɪnt/ n. 限制;约束;限定;严管
fragment /ˈfræɡmənt , fræɡˈment/ n. 片段;碎片
v.(使)碎裂,破裂,分裂
group /ɡruːp/ n. 组;集团;群;类;批;(尤指流行音乐的)演奏组,乐团,乐队;簇
v. 把…分组;(使)成群,成组,聚集;将…分类
image /ˈɪmɪdʒ/ n. (心目中的)形象;镜像;印象;画像;声誉;比喻;雕像;塑像
vt. 反映;象征;想像;作…的像
layout /ˈleɪaʊt/ n. 布局;布置;设计;安排
linear 英:/ˈlɪniə(r)/;美:/ˈlɪniər/ adj. 线性的;线的;直线的;长度的;线状的;通过单独的若干阶段来发展
pager 英:/ˈpeɪdʒə(r)/;美:/ˈpeɪdʒər/ n. 寻呼机;传呼机;BP机
网络释义:分页
relative /ˈrelətɪv/ adj. 相对的;比较的;关于(或涉及到)…的;相关联的;相比较而言的;相比之下存在(或有)的
n. 亲戚;亲属;同类事物
text /tekst/ n. 文本;(书籍或杂志的)正文,本文(并非附注、图片等);文档;文章;课本,教科书,剧本;文稿;剧本;演讲稿;《圣经》经文
v. (用手机给某人)发短信
view /vjuː/ n. 看法;方式;(个人的)意见;(理解或思维的)方法;(一次)观看;看;视野;(从某处看到的)景色,风景;态度;见解;视线;视域;风景照
vt. 看,观看(电视、电影等);看;把…视为;以…看待;(尤指)仔细察看;查看(房子等,以便购买或租用)