原生移动开发 / 系统课时
网格布局
网格布局
当内容天然适合按行列展示时,Compose 的 Lazy 网格比手工嵌套 Row 和 Column 更直接。本篇用一个可运行示例掌握 LazyVerticalGrid、LazyHorizontalGrid、固定与自适应网格,并说明尺寸、间距和滚动方向的关键边界。
学习目标
- 使用
LazyVerticalGrid和LazyHorizontalGrid构建纵向、横向滚动网格 - 根据页面宽度选择
GridCells.Fixed或GridCells.Adaptive - 正确设置网格尺寸、内容边距与单元格间距
先确定滚动方向与格子数量
LazyVerticalGrid 按列组织单元格,整体沿垂直方向滚动;它的核心参数是 columns。LazyHorizontalGrid 按行组织单元格,整体沿水平方向滚动;核心参数则是 rows。两者都会按需组合当前视口附近的内容,适合图片墙、商品卡片、快捷入口等可重复单元。
GridCells.Fixed(n) 表示始终使用固定列数或行数,适合布局规则明确的页面。GridCells.Adaptive(minSize) 先保证单元格不小于给定尺寸,再根据可用空间计算能放下多少列或行,因此更适合手机、平板和横屏之间的自适应布局。

构建一个纵向与横向网格
下面的示例在同一页面放置两个网格:上半部分使用自适应列宽的纵向网格,下半部分使用两行固定网格。两个 Lazy 容器都得到明确尺寸,因此可以独立计算可见区域并处理各自方向的滚动。
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.lazy.grid.GridCells
import androidx.compose.foundation.lazy.grid.LazyHorizontalGrid
import androidx.compose.foundation.lazy.grid.LazyVerticalGrid
import androidx.compose.foundation.lazy.grid.items
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
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 {
GridDemo()
}
}
}
}
@Composable
fun GridDemo() {
val names = (1..12).map { "项目 $it" }
Column(
modifier = Modifier
.fillMaxSize()
.padding(16.dp),
verticalArrangement = Arrangement.spacedBy(16.dp)
) {
LazyVerticalGrid(
columns = GridCells.Adaptive(minSize = 120.dp),
modifier = Modifier
.fillMaxWidth()
.height(280.dp),
contentPadding = PaddingValues(4.dp),
horizontalArrangement = Arrangement.spacedBy(8.dp),
verticalArrangement = Arrangement.spacedBy(8.dp)
) {
items(names) { name ->
GridCell(
name = name,
modifier = Modifier
.fillMaxWidth()
.height(72.dp)
)
}
}
LazyHorizontalGrid(
rows = GridCells.Fixed(2),
modifier = Modifier
.fillMaxWidth()
.height(160.dp),
contentPadding = PaddingValues(4.dp),
horizontalArrangement = Arrangement.spacedBy(8.dp),
verticalArrangement = Arrangement.spacedBy(8.dp)
) {
items(names) { name ->
GridCell(
name = name,
modifier = Modifier
.width(120.dp)
.height(72.dp)
)
}
}
}
}
@Composable
private fun GridCell(name: String, modifier: Modifier = Modifier) {
Surface(
modifier = modifier,
shape = MaterialTheme.shapes.medium,
tonalElevation = 2.dp
) {
Box(
modifier = Modifier.padding(16.dp),
contentAlignment = Alignment.Center
) {
Text(name)
}
}
}预期结果:页面上方出现可垂直滚动的卡片网格,列数会随可用宽度变化且每列至少约 120.dp;下方固定为两行,可左右滑动浏览 12 个项目。不同设备上的实际列数可能不同,这是 GridCells.Adaptive 的预期行为。
控制间距与内容边界
contentPadding 作用于网格内容内部,决定首尾单元格与容器边缘的留白;horizontalArrangement 和 verticalArrangement 控制格子之间的间距。不要为了制造间距给每个卡片重复叠加外层 padding,否则边缘与内部间距往往会不一致。
如果页面必须严格保持两列、三列等设计稿规则,选 GridCells.Fixed;如果更关心单元格最小可读宽度,而希望宽屏自动增加列数,选 GridCells.Adaptive。对图片墙或商品卡片来说,自适应方案通常能减少为不同屏宽手工切换列数的代码。
避免滚动容器尺寸冲突
Lazy 网格需要从父布局获得有限尺寸。把一个没有高度约束的 LazyVerticalGrid 放进同方向可滚动的 Column,或把没有宽度约束的横向网格放进同方向滚动父容器,容易产生测量冲突。更稳妥的做法是让一个 Lazy 容器负责同方向滚动,或显式提供 height、width 等边界。
当某个标题、分类栏需要横跨整行时,可以再使用网格项的 span 能力;但普通等宽卡片不必引入跨度逻辑。先确定滚动方向,再决定固定还是自适应格子,最后补齐尺寸与间距,就能覆盖大多数规则网格页面。