Jetpack Compose學習(9)——Compose中的列表控制項(LazyRow和LazyColumn)

来源:https://www.cnblogs.com/stars-one/archive/2022/08/11/15468564.html
-Advertisement-
Play Games

原文：Jetpack Compose學習(9)——Compose中的列表控制項(LazyRow和LazyColumn) - Stars-One的雜貨小窩 經過前面的學習,大致上已掌握了compose的基本使用了,本篇繼續進行擴展,講解下載Compose中的列表控制項LazyRow和LazyColumn ...


原文：Jetpack Compose學習(9)——Compose中的列表控制項(LazyRow和LazyColumn) - Stars-One的雜貨小窩

經過前面的學習,大致上已掌握了compose的基本使用了,本篇繼續進行擴展,講解下載Compose中的列表控制項LazyRow和LazyColumn

之前也是講解Jetpack Compose學習(6)——關於Modifier的妙用 | Stars-One的雜貨小窩,可以通過Modifier屬性將Row和Column組件改造為可滑動的

但是如果你需要顯示大量的項目（或一個未知長度的列表），使用像 Column 這樣的佈局會導致性能問題，因為所有的項目都會被組合和佈局，無論它們是否可見。

本系列以往文章請查看此分類鏈接Jetpack compose學習

基本使用

這裡由於LazyRow和LazyColumn用法相似,只是展示的方向不同,所以便是不各自分個章節出來了,下文以LazyColumn為例講解

@SuppressLint("UnrememberedMutableState")
@Preview(showBackground = true)
@Composable
fun ListPageDemo() {

    //可觸發重組的List
    val list = arrayListOf<String>()

    //構造數據
    repeat(30) {
        list.add("卡片$it")
    }
    
    ComposeDemoTheme {
        Column() {
            LazyColumn {
                items(list) {
                    Text(
                        it, modifier = Modifier
                            .fillMaxWidth()
                            .height(50.dp)
                    )
                }
            }
        }
    }

}

效果如下所示:

上面主要使用了LazyListScope里提供的items方法來構造列表

除此之外,LazyListScope也是提供了幾個不同的方法來構造列表

LazyColumn {
    // 添加單個項目
    item {
        Text(text = "First item")
    }

    // 添加五個項目
    items(5) { index ->
        Text(text = "Item: $index")
    }

    // 添加其他單個項目
    item {
        Text(text = "Last item")
    }
    
}

可觀察數據列表 mutableStateListOf()

上面那種,由於我們是使用的基本數據類型的ArrayList,所以在列表數據發生變更時,不會觸發重組

如果我們想要實現可觸發重組的數據列表,可以使用Compose中提供的mutableStateListOf()方法來創建數據列表

如下麵例子:

@SuppressLint("UnrememberedMutableState")
@Preview(showBackground = true)
@Composable
fun ListPageDemo() {

    //可觸發重組的List
    val list = mutableStateListOf<String>()

    repeat(30) {
        list.add("卡片$it")
    }
    ComposeDemoTheme {
        Box(modifier = Modifier) {
            Column() {
                LazyColumn {
                    items(list) {
                        Text(
                            it, modifier = Modifier
                                .fillMaxWidth()
                                .height(50.dp)
                        )
                    }
                }
            }
            //設置靠右下角
            Column(
                horizontalAlignment = Alignment.End,
                verticalArrangement = Arrangement.Bottom,
                modifier = Modifier.fillMaxSize().padding(end = 16.dp,bottom = 16.dp)
            ) {
                FloatingActionButton(onClick = {
                    //移除列表最後一個數據
                    list.removeLast()
                }) {
                    Icon(
                        imageVector = Icons.Default.Clear,
                        contentDescription = null
                    )
                }
                FloatingActionButton(onClick = {
                    //添加一個新的數據
                    val time = System.currentTimeMillis()
                    list.add(time.toString())
                }) {
                    Icon(
                        imageVector = Icons.Default.Add,
                        contentDescription = null
                    )
                }
            }
        }

    }
}

為了方便演示,加了兩個懸浮按鈕,用來測試數據的增加和刪除,效果如下所示:

mutableStateListOf()方法返回的類型是SnapshotStateList,此類型和ArrayList一樣,有著相關的添加,移除數據等方法,同時還能觸發Compose中的重組操作

屬性

我們從構造方法來看下LazyColumn具有什麼參數可以設置

fun LazyColumn(
    modifier: Modifier = Modifier,
    state: LazyListState = rememberLazyListState(),
    contentPadding: PaddingValues = PaddingValues(0.dp),
    reverseLayout: Boolean = false,
    verticalArrangement: Arrangement.Vertical =
        if (!reverseLayout) Arrangement.Top else Arrangement.Bottom,
    horizontalAlignment: Alignment.Horizontal = Alignment.Start,
    flingBehavior: FlingBehavior = ScrollableDefaults.flingBehavior(),
    content: LazyListScope.() -> Unit
){}

modifier想必也不用多說了,不清楚了可以看下前面的文章

FlingBehavior這個屬性是用於定義滑動動作釋放後的速度變化邏輯的，比如，當滑動動作釋放後，列表還將繼續滑動，速度依時遞減

此屬性有點不太常用,就不講解了

由於state這個屬性涉及東西較多,所以單獨放在後面講解

contentPadding

此屬性主要是用來設置內邊距的,取值為PaddingValues

PaddingValues方法的參數有三種,根據需要選擇即可:

  • PaddingValues(all:Dp)
  • PaddingValues(horizontal: Dp, vertical: Dp)
  • PaddingValues(start: Dp = 0.dp,top: Dp = 0.dp,end: Dp = 0.dp,bottom: Dp = 0.dp)

示例代碼(設置內邊距為16dp):

LazyColumn(contentPadding = PaddingValues(16.dp)) {
    items(list) {
        Text(
            it, modifier = Modifier
                .fillMaxWidth()
                .height(50.dp)
        )
    }
}

效果:

reverseLayout

將列表順序反轉過來,接收一個boolean數值

示例代碼:

LazyColumn(reverseLayout = true) {
    items(list) {
        Text(
            it, modifier = Modifier
                .fillMaxWidth()
                .height(50.dp)
        )
    }
}

效果:

PS:這個時候如果新增一個數據項item,item會出現在最上面的位置

verticalArrangement

此屬性組主要是用來設置item的相互間距,針對的是LazyColumn

PS: LazyRow則是horizontalArrangement屬性

LazyColumn(verticalArrangement = Arrangement.spacedBy(10.dp)) {
    items(list) {
        Text(
            it, modifier = Modifier
                .fillMaxWidth()
                .height(50.dp)
                .background(color = Color.Yellow)
        )
    }
}

效果:

horizontalAlignment

設置水平對齊方式,是針對LazyColumn

PS:LazyRow中的屬性則是verticalAlignment

LazyColumn(Modifier.fillMaxWidth(),horizontalAlignment = Alignment.End) {
    items(list) {
        Text(
            it, modifier = Modifier
                .height(50.dp)
                .background(color = Color.Yellow)
        )
    }
}

註意,要設置LazyColumn為填充最大寬度,然後item項是沒有最大寬度的,才會看到效果

效果:

state

接收LazyListState對象,主要是提供一個可觀察的狀態,用來實現控制和觀察列表組件,如滾動到列表某一項的時候,需要展示一個懸浮按鈕等邏輯

LazyListState有以下常用屬性:

  • firstVisibleItemIndex 當前頁面列表顯示的第一項的下標
  • firstVisibleItemScrollOffset 當前頁面列表顯示的第一項的滑動偏移量
  • interactionSource 當列表被拖拽時候,會觸發對應的分發事件,interactionSource存放著相關的事件state
  • layoutInfo 列表佈局相關信息
  • isScrollInProgress 一個boolean數值,標識當前列表是否處於滑動狀態

對滾動位置做出反應示例

我們以firstVisibleItemIndex為例,可以實現滾動到列表某一項的時候,需要展示一個懸浮按鈕的功能

要實現上述功能,肯定得要一個boolean的state對象才行,但firstVisibleItemIndex只是一個Int類型,如何將其轉換為可觀察的boolean數值(MutableState<Boolean>)呢?

這裡可以使用derivedStateOf()方法來進行轉換

val state = rememberLazyListState()
val showButton by remember {
    derivedStateOf {
        state.firstVisibleItemIndex > 5
    }
}

示例代碼:

@SuppressLint("UnrememberedMutableState")
@Preview(showBackground = true)
@Composable
fun ListPageDemo() {

    //可觸發重組的List
    val list = mutableStateListOf<String>()

    repeat(30) {
        list.add("卡片$it")
    }
    val state = rememberLazyListState()


    val showButton by remember {
        derivedStateOf {
            state.firstVisibleItemIndex > 5
        }
    }
   
    ComposeDemoTheme {
        Box(modifier = Modifier) {
            Column() {
                LazyColumn(state = state,modifier = Modifier.fillMaxWidth()) {
                    items(list) {
                        Text(
                            it, modifier = Modifier
                                .height(50.dp)
                                .background(color = Color.Yellow)
                        )
                    }
                }
            }

            if (showButton) {
                //這裡由於要設置懸浮按鈕的位置,所以外層需要一個Box佈局
                Box(Modifier.fillMaxSize().padding(bottom = 16.dp),contentAlignment = Alignment.BottomCenter) {
                    FloatingActionButton(onClick = {
                    }) {
                        Icon(
                            imageVector = Icons.Default.KeyboardArrowUp,
                            contentDescription = null
                        )
                    }
                }
            }
            //設置靠右下角
            Column(
                horizontalAlignment = Alignment.End,
                verticalArrangement = Arrangement.Bottom,
                modifier = Modifier
                    .fillMaxSize()
                    .padding(end = 16.dp, bottom = 16.dp)
            ) {
                FloatingActionButton(onClick = {
                    //移除列表最後一個數據
                    list.removeLast()
                }) {
                    Icon(
                        imageVector = Icons.Default.Clear,
                        contentDescription = null
                    )
                }
                FloatingActionButton(onClick = {
                    //添加一個新的數據
                    val time = System.currentTimeMillis()
                    list.add(time.toString())
                }) {
                    Icon(
                        imageVector = Icons.Default.Add,
                        contentDescription = null
                    )
                }
            }
        }

    }
}

可以從下圖看到,當列表的第一項為卡片6的時候,按鈕即顯示出來了:

控制滾動

除此之外,LazyListState還提供了一些方法,可以讓我們控制列表自動滾動

  • scrollToItem(index:Int,scrollOffset: Int = 0) 滾動到指定的數據項
  • animateScrollToItem(index:Int,scrollOffset: Int = 0) 平滑滾動到指定的數據項

註意這兩個方法都是掛起方法,需要在協程中使用

我們基於上面的例子,加以改造下,實現點擊懸浮按鈕,列表滾動回頂部的功能

為例方便閱讀,下麵的代碼稍微省略了一些不重要的代碼:

@SuppressLint("UnrememberedMutableState")
@Preview(showBackground = true)
@Composable
fun ListPageDemo() {

    ...
    
    // 記住一個協程作用域，以便能夠啟動滾動操作
    val coroutineScope = rememberCoroutineScope()
   
    FloatingActionButton(onClick = {
        coroutineScope.launch {
            //滾動到第一項
            state.animateScrollToItem(0)
        }
    }) {
        Icon(
            imageVector = Icons.Default.KeyboardArrowUp,
            contentDescription = null
        )
    }
}

這裡需要註意的是,使用滾動得通過協程來進行調用,通過rememberCoroutineScope()來得到一個協程作用域對象

效果如下圖所示:

高級使用

1.粘性標題

LazyListScope除了items等方法,還有stickyHeader方法,幫助我們快速實現粘性標題的效果,如下圖所示:

代碼:

//可觸發重組的List
val list = mutableStateListOf<String>()

repeat(30) {
    list.add("title1 卡片$it")
}

//可觸發重組的List
val list1 = mutableStateListOf<String>()

repeat(30) {
    list1.add("title2 卡片$it")
}
    
LazyColumn(state = state, modifier = Modifier.fillMaxWidth()) {

    stickyHeader {
        Text(
            "title1",
            modifier = Modifier
                .fillMaxWidth()
                .background(color = Color.Green)
        )
    }
    items(list){
        Text(
            it, modifier = Modifier
                .height(50.dp)
                .background(color = Color.Yellow)
        )
    }
    stickyHeader {
        Text(
            "title2",
            modifier = Modifier
                .fillMaxWidth()
                .background(color = Color.Green)
        )
    }
    items(list1){
        Text(
            it, modifier = Modifier
                .height(50.dp)
                .background(color = Color.Yellow)
        )
    }

}

上面與之前的代碼,多了一個數據源list1來,當然還可以把代碼通過迴圈來精簡一下,這裡不再過多補充了

2.item動畫

  • animateItemPlacement 但item重新排序的動畫

截止到目前,item動畫目前只有重新排序的動畫,其他的添加和移除item的動畫官方還在開發中,詳情可看問題 150812265

測試的時候發現沒有此API,似乎也是1.2.0以後的版本才有的API,而且是在實驗中

示例代碼:

LazyColumn {
    items(books, key = { it.id }) {
        Row(Modifier.animateItemPlacement()) {
            // ...
        }
    }
}

自定義動畫:

LazyColumn {
    items(books, key = { it.id }) {
        Row(Modifier.animateItemPlacement(
            tween(durationMillis = 250)
        )) {
            // ...
        }
    }
}

PS: 關於自定義動畫,後面我會再出新的章節講解,目前代碼就先貼著

3.分頁

藉助 Paging 庫，應用可以支持包含大量列表項的列表，根據需要載入和顯示小塊的列表。Paging 3.0 及更高版本通過 androidx.paging:paging-compose 庫提供 Compose 支持。

註意：只有 Paging 3.0 及更高版本提供 Compose 支持。如果您使用的是較低版本的 Paging 庫，則需先遷移到 3.0。

如需顯示分頁內容列表，可以使用 collectAsLazyPagingItems() 擴展函數，然後將返回的 LazyPagingItems 傳入 LazyColumn 中的 items()。

與視圖中的 Paging 支持類似，您可以通過檢查 item 是否為 null，在載入數據時顯示占位符

import androidx.paging.compose.collectAsLazyPagingItems
import androidx.paging.compose.items

@Composable
fun MessageList(pager: Pager<Int, Message>) {
    val lazyPagingItems = pager.flow.collectAsLazyPagingItems()

    LazyColumn {
        items(
          items = lazyPagingItems,
          // The key is important so the Lazy list can remember your
          // scroll position when more items are fetched!
          key = { message -> message.id }
        ) { message ->
            if (message != null) {
                MessageRow(message)
            } else {
                MessagePlaceholder()
            }
        }
    }
}

暫時貼上些代碼,後面可能與網路請求一起講解,敬請期待...

更優雅使用列表組件

1.item綁定key

在上文開始也提到,我們是使用LazyListScope里的items方法來構建數據項的,但是我們並沒有為我們的每一項數據設置一個key,所以會導致以下問題:

如果數據集發生變化，這可能會導致問題，因為改變位置的 item 會失去任何記憶中的狀態。
如果你想象一下 LazyRow 在LazyColumn 中的情景，如果該行改變了 item 的位置，用戶就會失去他們在該行中的滾動位置。

所以這個時候,我們可以通過items方法里的keys參數來進行設置

此參數接收一個lambda表達式(item: T) -> Any

這裡的Any是這裡可返回任何類型的數據,但必須要要所提供的數據必須能夠被存儲在一個Bundle中,具體可點擊鏈接查看該類文檔

LazyColumn(state = state, modifier = Modifier.fillMaxWidth()) {
    items(list, key = {
        //這裡可返回任何類型的數據(Any),但必須要要所提供的數據必須能夠被存儲在一個 Bundle 中
        //直接使用本身作為字元串
        it
    }) {
        Text(
            it, modifier = Modifier
                .height(50.dp)
                .background(color = Color.Yellow)
        )
    }
}

2.使用contentType更好復用組件

如果需要復用數據項內容時,可使用contentType來標明類型,如下的示例代碼

PS:此API在1.2.0版本提供,截止發文日期,1.2.0還處於beta中,可以查閱Jetpack各庫版本

LazyColumn {
    items(elements, contentType = { it.type }) {
        // ...
    }
}

3.item的註意項

  • item最好定義固定寬高

例如，當您希望在後期階段非同步檢索一些數據（例如圖片）以填充列表項時。

這會使延遲佈局在首次衡量時組合其所有項，因為項的高度為 0 像素，所以這類項可完全適合視口大小。

待這些項載入完畢且高度增加後，延遲佈局隨後會捨棄首次不必要組合起來的所有其他項，因為這些項實際上無法適合視口。

@Composable
fun Item() {
    Image(
        painter = rememberImagePainter(data = imageUrl),
        modifier = Modifier.size(30.dp),
        // ...
    )
}
  • 建議多個元素放入一個項中
LazyColumn(
    // ...
) {
    item { Item(0) }
    item {
        Item(1)
        Divider()
    }
    item { Item(2) }
    // ...
}
  • 避免嵌套可向同一方向滾動的組件

如以下不推薦的代碼:

// Throws IllegalStateException
Column(
    modifier = Modifier.verticalScroll(state)
) {
    LazyColumn {
        // ...
    }
}

參考

提問之前，請先看提問須知 點擊右側圖標發起提問 聯繫我 或者加入QQ群一起學習 Stars-One安卓學習交流群 TornadoFx學習交流群:1071184701
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • ASP.NET Core依賴註入系統學習教程：4.體驗服務的註冊和消費
    作為一個沒有系統學習過依賴註入的開發者而言，如果直接在一個使用依賴註入的框架下進行開發，往往對於依賴註入的存在是沒有明顯的察覺，通過代碼追根溯源你都會看不出對象是從哪裡創建的。但這並不影響你進行開發的工作，你可以參照現有代碼的使用形式，將需要使用的對象加入到構造函數的參數列表上，你就可以使用對象，調 ...
  • 0811JDBC隨筆
    1.JDBC體繫系統 一組規範：介面 JDBC介面（API）包括兩個層次： 面嚮應用的API：Java API，抽象介面，供應用開發人員使用（連接資料庫，執行SQL語句，獲得結果） 面向資料庫的API：Java Driver API，供開發商開發資料庫驅動程式 JDBC是sun公司提供一套用於資料庫 ...
  • ETCD快速入門-03 常用命令
    3. ETCD 常用命令 etcdctl是一個命令行的客戶端，它提供了一些命令，可以方便我們在對服務進行測試或者手動修改資料庫內容。etcdctl與kubectl和systemctl的命令原理及操作類似，其基本用法如下所示： etcdctl [global options] command [com ...
  • centos8安裝mysql
    前言 最近在centos8系統下部署django項目時，要用到mysql資料庫，在安裝中遇到了點坑，之後參考了一位博主的文章，也是順利的安裝配置成功，博主原文連接： []((20條消息) centos8安裝mysql8.0.22教程(超詳細)_上善若水滴世界的博客-CSDN博客_centos mys ...
  • Apache DolphinScheduler 3.0.0 正式版發佈！
    ​ 點亮 ⭐️ Star · 照亮開源之路 GitHub:https://github.com/apache/dolphinscheduler ​ 版本發佈 2022/8/10 2022 年 8 月 10 日，Apache DolphinScheduler 在經過 3.0.0 alpha、3.0.0 ...
  • 手把手教你定位線上MySQL鎖超時問題，包教包會
    昨晚我正在床上睡得著著的，突然來了一條簡訊。 什麼？線上的訂單無法取消！ 我趕緊登錄線上系統，查看業務日誌。發現有MySQL鎖超時的錯誤日誌。 ...
  • 開源項目丨一文詳解一站式大數據平臺運維管家ChengYing如何部署Hadoop集群
    課件獲取：關註公眾號“數棧研習社”，後臺私信 “ChengYing” 獲得直播課件 視頻回放：點擊這裡 ChengYing開源項目地址：github 丨 gitee 喜歡我們的項目給我們點個__ STAR！STAR！！STAR！！！（重要的事情說三遍）__ 技術交流釘釘 qun：30537511 本 ...
  • （記錄自用，參考價值低）分散式大數據處理Hadoop學習與探索1：虛擬機
    首先nosql可以被理解為not only sql 泛指非關係型資料庫，也就是說不僅僅是sql，所以它既包含了sql的一些東西，但是又和sql不同，併在其的基礎上改變或者說擴展了一些東西。 提到nosql，首先我們就要分析一下關係型資料庫的行式存儲和非關係型資料庫的列式存儲區別在哪？ 行式存儲我們都 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類