如何在Kotlin中对Paging3的LazyPagingItems进行搜索过滤？

直接在UI层过滤LazyPagingItems的做法不可取——因为它只包含当前加载的页面数据，过滤后会丢失其他页的匹配结果，且新分页加载的数据不会自动应用过滤规则，导致搜索结果不完整。正确的实现是让数据源根据搜索参数重新加载匹配数据，具体步骤如下：

1. 在ViewModel中维护搜索状态并关联分页流 #

ViewModel里需要保存搜索文本的状态，并通过flatMapLatest在搜索文本变化时，重新创建带搜索参数的分页流：

class YourViewModel : ViewModel() {
    // 搜索文本状态
    private val _searchText = MutableStateFlow("")
    val searchText = _searchText.asStateFlow()

    // 根据搜索文本生成分页数据
    val getValues = searchText.flatMapLatest { query ->
        Pager(
            config = PagingConfig(pageSize = 20),
            pagingSourceFactory = { YourPagingSource(query) }
        ).flow
    }.cachedIn(viewModelScope)

    // 更新搜索文本的方法
    fun updateSearchText(text: String) {
        _searchText.value = text
    }
}

2. 修改PagingSource，传入搜索参数过滤数据 #

让PagingSource接收搜索参数，在load方法中调用数据源（API/本地数据库）时，传入搜索条件获取匹配的数据：

class YourPagingSource(private val searchQuery: String) : PagingSource<Int, YourDataModel>() {
    override suspend fun load(params: LoadParams<Int>): LoadResult<Int, YourDataModel> {
        return try {
            val currentPage = params.key ?: 1
            // 调用数据源时传入搜索参数，直接获取匹配的数据
            val response = yourRepository.fetchData(
                page = currentPage,
                pageSize = params.loadSize,
                searchQuery = searchQuery
            )
            
            LoadResult.Page(
                data = response.data,
                prevKey = if (currentPage == 1) null else currentPage - 1,
                nextKey = if (response.hasNextPage) currentPage + 1 else null
            )
        } catch (e: Exception) {
            LoadResult.Error(e)
        }
    }

    override fun getRefreshKey(state: PagingState<Int, YourDataModel>): Int? {
        return state.anchorPosition?.let { anchorPosition ->
            state.closestPageToPosition(anchorPosition)?.prevKey 
                ?: state.closestPageToPosition(anchorPosition)?.nextKey
        }
    }
}

如果是本地数据库，可以在DAO层添加带搜索条件的查询语句，避免在内存中过滤数据。

3. UI层绑定搜索框，直接使用分页数据 #

在UI中，只需要将搜索框的输入同步到ViewModel，然后直接使用LazyPagingItems渲染列表即可：

@Composable
fun YourScreen(viewModel: YourViewModel = viewModel()) {
    val searchTextFieldState = remember { mutableStateOf(TextFieldValue("")) }
    val values = viewModel.getValues.collectAsLazyPagingItems()

    Column {
        // 搜索输入框
        TextField(
            value = searchTextFieldState.value,
            onValueChange = { newState ->
                searchTextFieldState.value = newState
                viewModel.updateSearchText(newState.text)
            },
            placeholder = { Text("输入关键词搜索") }
        )

        // 分页列表
        LazyColumn(modifier = Modifier.background(Color.Gray)) {
            items(values) { value ->
                value?.let {
                    // 渲染你的列表项
                    ListItem(data = it)
                }
            }

            // 处理分页加载状态
            values.apply {
                when {
                    loadState.refresh is LoadState.Loading -> item { LoadingIndicator() }
                    loadState.append is LoadState.Loading -> item { LoadingIndicator() }
                    loadState.refresh is LoadState.Error -> {
                        val error = loadState.refresh as LoadState.Error
                        item { ErrorItem(error) { retry() } }
                    }
                }
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者VigneshK