原生移动开发 / 系统课时
滚动容器与内容布局
滚动容器与内容布局
当页面内容超过屏幕尺寸时,需要让布局获得滚动能力。本节用 verticalScroll 与 horizontalScroll 分别处理纵向和横向溢出,并说明它们适合“小规模、一次性组合全部子项”的页面,而不是海量数据列表。
学习目标
- 使用
rememberScrollState配合verticalScroll、horizontalScroll创建滚动区域 - 为滚动容器设置正确的尺寸约束,避免内容无法滚动或无限扩张
- 判断普通滚动容器与惰性列表的适用边界
滚动的本质是内容超出可视区域
Column 和 Row 本身不会因为内容过多而自动滚动。给 Column 添加 verticalScroll 后,子项仍按纵向排列,但用户可以拖动查看超出可视区域的部分;Row 配合 horizontalScroll 时同理。
滚动能否发生取决于两个条件:容器必须有有限的可视尺寸,内容总尺寸还要大于这个可视区域。如果父布局让滚动容器沿滚动方向无限扩张,就没有“超出可视区域”的部分,自然也无法产生预期滚动。
同时构建纵向与横向滚动区域
下面示例可直接放入一个已启用 Jetpack Compose 的 Android 项目中,替换 MainActivity.kt。页面主体可以纵向滚动,中间的卡片行可以横向滚动。
package com.example.scrollsample
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.background
import androidx.compose.foundation.horizontalScroll
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
ScrollScreen()
}
}
}
}
@Composable
fun ScrollScreen() {
Column(
modifier = Modifier
.fillMaxSize()
.verticalScroll(rememberScrollState())
.padding(16.dp),
verticalArrangement = Arrangement.spacedBy(12.dp)
) {
Text("纵向内容开始", style = MaterialTheme.typography.titleLarge)
Row(
modifier = Modifier.horizontalScroll(rememberScrollState()),
horizontalArrangement = Arrangement.spacedBy(8.dp)
) {
repeat(8) { index ->
Box(
modifier = Modifier
.width(140.dp)
.height(80.dp)
.background(MaterialTheme.colorScheme.primaryContainer),
contentAlignment = Alignment.Center
) {
Text("卡片 ${index + 1}")
}
}
}
repeat(20) { index ->
Text("纵向条目 ${index + 1}")
}
}
}预期结果
页面可以上下滚动查看“纵向条目 1~20”;中间的卡片区域可以独立左右拖动查看 8 张卡片。两个方向使用了各自的 ScrollState。通常不要让彼此无关的滚动区域共享同一个状态,否则滚动位置会产生不合理的耦合。
尺寸约束决定滚动是否成立
最常见的问题不是 API 写错,而是约束不合理。例如,把纵向滚动的 Column 放进另一个同方向、没有明确高度边界的滚动容器,容易导致测量异常或得到不可预测的体验。
在实际界面中,优先让滚动区域拿到明确的可视范围,例如使用 fillMaxSize() 占据屏幕剩余空间,或在父 Column 中通过 weight(1f) 分配有限高度。横向滚动区域也应避免使用让它无限扩张的父约束。
什么时候不要使用普通滚动容器
verticalScroll 与 horizontalScroll 会组合它们内部声明的所有子项。几十个静态设置项、详情页、说明页通常没有问题;如果要展示数百或数千条数据,即使屏幕一次只显示其中很少一部分,也会提前创建大量组合内容。
这时应改用 LazyColumn 或 LazyRow,让 Compose 只为当前可见区域及附近内容进行惰性组合。普通滚动容器解决的是“内容尺寸超出屏幕”,惰性列表解决的是“数据量很大且不应一次构建全部项目”。