SwiftUI 如何实现双列卡片网格,点击卡片后展开为全屏视图?
将展开状态放在父视图中,让全屏笔记和 ScrollView 成为同一个根级 ZStack 的子视图,再用 matchedGeometryEffect 连接网格卡片和全屏笔记。展开时,在网格中保留等高占位并移除对应的小卡片,同时在上层插入全屏视图。
这样可以继续使用 withAnimation,也能让全屏视图拥有独立于 LazyVGrid 的布局空间。
为什么直接修改卡片尺寸会出现问题
withAnimation 会为状态变化引起的可动画属性变化添加动画,但不会改变视图的父子关系。卡片仍然是 LazyVGrid 的单元格,增大它的 frame 会影响网格布局,绘制结果也可能受到滚动容器的裁剪限制。
.zIndex(1) 控制同一布局层级中的绘制顺序,无法把网格内部的卡片提升为根视图上的全屏覆盖层。
matchedGeometryEffect 负责关联两个视图的几何变化,仍然需要正确的视图层级、匹配标识和目标布局。仅凭第一个示例,无法确定从左上角进入的唯一原因,还需要结合实际容器布局和修饰符顺序检查。
如何组织视图和状态
父视图保存当前选中的笔记,每张卡片负责显示内容:
- 点击卡片时,在
withAnimation中设置选中的笔记。 - 网格在原位置保留占位,暂时移除该笔记的小卡片,避免其他卡片重新排列。
- 根级
ZStack插入全屏笔记,使用相同的Namespace和笔记 ID 进行匹配。 - 关闭时清空选中状态,让视图执行反向动画。
每条笔记都需要稳定且唯一的 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 标签页的展开交互,具体视觉细节仍需要按界面设计调整。
备注:内容仅供参考。
