Jetpack：021-Jetpack中的滑动列表

news2025/2/26 14:43:44

文章目录

1. 概念介绍
2. 使用方法
- 2.1 函数参数
- 2.2 列表成员
3. 示例代码
4. 内容扩展
5. 内容总结

我们在上一章回中介绍了Jetpack中底部导航栏相关的内容，本章回中主要介绍 滑动列表。闲话休提，让我们一起Talk Android Jetpack吧！

1. 概念介绍

我们先看一个场景：大家在使用手机时会打开联系人查找某位朋友，由于联系人比较多需要上下滑动才可以找到这位朋友，显示这么多联系人的页面就是滑动列表，它有两个特点：

每行显示相同或者相似的内容；
内容超过手机屏幕时可以滑动显示；

如果使用View开发Android时可以通过ListView或者RecycleView组件实现滑动列表，如果使用Compose开发时可以通过LazyColumn可组合函数实现滑动列表，本章回中将详细介LazyColumn这种滑动列表的使用方法。

2. 使用方法

可组合函数LazyColumn主要控制滑动列表，列表中的成员需要通过可组合函数Item控制。接下来我们分别介绍这两个可组合函数。

2.1 函数参数

可组合函数LazyColumn提供了相关的参数来控制列表，下面是常用的参数：

contentPadding参数：主要用来控制列表内容的间距，它会影响滑动列表中所有的内容；
reverseLayout参数：表示是否把列表内容倒置，默认值为false,表示正常显示列表中的内容；
userScrollEnabled参数：表示是否让滑动列表中的内容滚动显示，默认值为true，表示可以滑动显示；
content参数:用来存滑动列表中的内容，它的类型是LazyListScope.() -> Unit，需要通过item函数来赋值；

除了上面介绍的参数外，该函数和Column函数拥有一些共同的参数，比如控制对齐的horizontalAlignment和verticalArrangement参数，这些参数的功能我们在Column函数中介绍过，这里就详细介绍了，如果有看官忘记的话可以点击这里查看以前的内容。

2.2 列表成员

列表成员通过Item和Items函数来实现，通常使用尾lambda语法把它放到LazyColumn函数中，还有一个Items函数，它与Item的区别在于可以把整个列表当作滑动列表的成员，相当于是列表赋值。

这两个函数没有太多的参数，只有一个content参数比较常用，稍后我们将通过示例代码来演示这两个函数的使用方法。

3. 示例代码

LazyColumn(
    //需要通过scaffold传递的参数来设置顶部的边距，不然topBar会和mainScreen中的内容重叠
    modifier = Modifier.padding( top = paddingValues.calculateTopPadding()),
    contentPadding = PaddingValues(horizontal = 16.dp),
    //指定list内容之间的间隔
    verticalArrangement = Arrangement.spacedBy(8.dp),
    //控制列表是否能够滚动，默认值为true，表示可以滚动
    userScrollEnabled = false
) {
    //不能直接使用可组合函数赋值,需要借助item函数
//        Text(text = "this is a list")
    item {
        Text(text = "this is a list")
    }


    //指定list的数量,并且添加分隔线
    items( count = 9, itemContent = { index ->
        Text(text = "This is item ${index+1}")
        Divider(color = Color(0.1f,0.8f,0.9f,1.0f))
    })

    //通过items直接使用list
    items(strList){ item ->
        Text(text = item )
    }
}