原生移动开发 / 系统课时

网格布局

网格布局

当内容天然适合按行列展示时,Compose 的 Lazy 网格比手工嵌套 Row 和 Column 更直接。本篇用一个可运行示例掌握 LazyVerticalGrid、LazyHorizontalGrid、固定与自适应网格,并说明尺寸、间距和滚动方向的关键边界。

学习目标

  • 使用 LazyVerticalGrid 和 LazyHorizontalGrid 构建纵向、横向滚动网格
  • 根据页面宽度选择 GridCells.Fixed 或 GridCells.Adaptive
  • 正确设置网格尺寸、内容边距与单元格间距

先确定滚动方向与格子数量

LazyVerticalGrid 按列组织单元格,整体沿垂直方向滚动;它的核心参数是 columns。LazyHorizontalGrid 按行组织单元格,整体沿水平方向滚动;核心参数则是 rows。两者都会按需组合当前视口附近的内容,适合图片墙、商品卡片、快捷入口等可重复单元。

GridCells.Fixed(n) 表示始终使用固定列数或行数,适合布局规则明确的页面。GridCells.Adaptive(minSize) 先保证单元格不小于给定尺寸,再根据可用空间计算能放下多少列或行,因此更适合手机、平板和横屏之间的自适应布局。

纵向与横向 Lazy 网格的布局关系

构建一个纵向与横向网格

下面的示例在同一页面放置两个网格:上半部分使用自适应列宽的纵向网格,下半部分使用两行固定网格。两个 Lazy 容器都得到明确尺寸,因此可以独立计算可见区域并处理各自方向的滚动。

kotlin
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 能力;但普通等宽卡片不必引入跨度逻辑。先确定滚动方向,再决定固定还是自适应格子,最后补齐尺寸与间距,就能覆盖大多数规则网格页面。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

网格布局

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通