PAYATHON 2026

SwiftUI 如何实现双列卡片网格,点击卡片后展开为全屏视图?

数据小许

将展开状态放在父视图中,让全屏笔记和 ScrollView 成为同一个根级 ZStack 的子视图,再用 matchedGeometryEffect 连接网格卡片和全屏笔记。展开时,在网格中保留等高占位并移除对应的小卡片,同时在上层插入全屏视图。

这样可以继续使用 withAnimation,也能让全屏视图拥有独立于 LazyVGrid 的布局空间。

为什么直接修改卡片尺寸会出现问题

withAnimation 会为状态变化引起的可动画属性变化添加动画,但不会改变视图的父子关系。卡片仍然是 LazyVGrid 的单元格,增大它的 frame 会影响网格布局,绘制结果也可能受到滚动容器的裁剪限制。

.zIndex(1) 控制同一布局层级中的绘制顺序,无法把网格内部的卡片提升为根视图上的全屏覆盖层。

matchedGeometryEffect 负责关联两个视图的几何变化,仍然需要正确的视图层级、匹配标识和目标布局。仅凭第一个示例,无法确定从左上角进入的唯一原因,还需要结合实际容器布局和修饰符顺序检查。

如何组织视图和状态

父视图保存当前选中的笔记,每张卡片负责显示内容:

  1. 点击卡片时,在 withAnimation 中设置选中的笔记。
  2. 网格在原位置保留占位,暂时移除该笔记的小卡片,避免其他卡片重新排列。
  3. 根级 ZStack 插入全屏笔记,使用相同的 Namespace 和笔记 ID 进行匹配。
  4. 关闭时清空选中状态,让视图执行反向动画。

每条笔记都需要稳定且唯一的 ID。原示例中的 "card" 适用于只有一对匹配视图的演示;扩展到整个网格后,不能给所有卡片使用同一个匹配 ID。

代码示例

示例用标题代表笔记内容:点击卡片展开,点击展开后的视图关闭。实际使用时,可以在全屏视图中加入笔记正文和独立的关闭按钮。

import SwiftUI

private struct Note: Identifiable {
    let id: Int
    let title: String
}

private struct NoteSurface: View {
    let title: String

    var body: some View {
        VStack {
            Spacer()

            Text(title)
                .font(.headline)
                .foregroundStyle(.white)
                .padding()

            Spacer()
        }
        .frame(maxWidth: .infinity, maxHeight: .infinity)
        .background(Color.blue)
        .contentShape(Rectangle())
    }
}

struct ParentView: View {
    @Namespace private var namespace
    @State private var selectedNote: Note?

    private let notes = (0..<20).map {
        Note(id: $0, title: "Note \($0 + 1)")
    }

    private let columns = [
        GridItem(.flexible(), spacing: 16),
        GridItem(.flexible(), spacing: 16)
    ]

    var body: some View {
        ZStack {
            ScrollView {
                LazyVGrid(columns: columns, spacing: 16) {
                    ForEach(notes) { note in
                        ZStack {
                            // Keep the cell's layout space while expanded.
                            Color.clear
                                .frame(height: 200)

                            if selectedNote?.id != note.id {
                                NoteSurface(title: note.title)
                                    .matchedGeometryEffect(
                                        id: note.id,
                                        in: namespace
                                    )
                                    .frame(height: 200)
                                    .transition(.identity)
                                    .onTapGesture {
                                        withAnimation(
                                            .spring(
                                                response: 0.45,
                                                dampingFraction: 0.85
                                            )
                                        ) {
                                            selectedNote = note
                                        }
                                    }
                            }
                        }
                    }
                }
                .padding(16)
            }
            .allowsHitTesting(selectedNote == nil)

            if let note = selectedNote {
                NoteSurface(title: note.title)
                    .matchedGeometryEffect(
                        id: note.id,
                        in: namespace
                    )
                    .frame(
                        maxWidth: .infinity,
                        maxHeight: .infinity
                    )
                    .ignoresSafeArea()
                    .transition(.identity)
                    .zIndex(1)
                    .onTapGesture {
                        withAnimation(
                            .spring(
                                response: 0.45,
                                dampingFraction: 0.85
                            )
                        ) {
                            selectedNote = nil
                        }
                    }
            }
        }
        .frame(maxWidth: .infinity, maxHeight: .infinity)
    }
}

示例中几个容易忽略的细节

网格保留占位,匹配的小卡片暂时移除

Color.clear.frame(height: 200) 让展开后的单元格继续占据原来的空间。关闭笔记时,目标位置仍然存在,其他卡片也不会因为该卡片被移除而向前补位。

示例通过条件分支切换小卡片和全屏视图。不要直接改为始终保留小卡片、只将它的 opacity 设为 0:透明视图依然存在,两个匹配视图都使用默认的 isSource: true 时,会造成匹配源冲突。如果同时保留两端视图,需要另行管理 isSource。

让匹配的表面接受外部尺寸

NoteSurface 内部使用可伸展的布局,外部分别给它设置卡片高度或全屏尺寸。这里把 matchedGeometryEffect 放在外部尺寸约束之前,让同一个表面参与尺寸和位置的匹配。

修饰符顺序会影响匹配的是哪一层布局。如果仍然出现只有位置变化、背景突然变大等表现,应检查固定尺寸、背景和 matchedGeometryEffect 的相对位置。

.transition(.identity) 用于避免额外的淡入淡出干扰这次几何过渡。示例中的 spring 参数可以调整。

全屏范围由父容器决定

示例让展开视图填满父容器,并通过 .ignoresSafeArea() 延伸到安全区域。这里没有使用 UIScreen.main.bounds,这样更符合当前窗口的实际布局,也避免直接假定应用始终占满物理屏幕。

如果 ParentView 被放进一个较小的容器,它最多只能覆盖该容器允许的范围。如果还需要覆盖导航栏或标签栏,应把负责展开的 ZStack 放到包含这些界面的更外层,或根据应用结构管理栏的显示状态。

加入笔记编辑器和关闭按钮时,可以让背景覆盖安全区域,同时让交互控件保持安全区域内的边距。

保持返回目标稳定

LazyVGrid 会按需创建视图。示例在展开期间禁用了底层滚动区域的触摸,帮助保留当前滚动位置。如果应用还会通过代码滚动、删除笔记或刷新列表,需要保证关闭动画发生时,对应卡片仍有可用的布局位置。

matchedGeometryEffect 主要处理几何变化,不会自动把复杂的卡片内容变形成完整编辑界面。可以先匹配背景和标题,再为正文、工具栏添加独立的显示动画。它能实现类似 Safari 标签页的展开交互,具体视觉细节仍需要按界面设计调整。

备注:内容仅供参考。