SwiftUI 26 功能
概述
适用于 iOS 26、iPadOS 26、macOS Tahoe、watchOS 26 和 visionOS 26 的 SwiftUI 新功能全面指南。从 Liquid Glass 设计系统到富文本编辑,这些增强功能使 SwiftUI 在所有 Apple 平台上更强大。
核心原则 从底层性能改进一直到用户界面中的按钮,整个系统都有一些重大改进。
何时使用此技能
- 采用 Liquid Glass 设计系统
- 使用 AttributedString 实现富文本编辑
- 使用 WebView 嵌入网页内容
- 优化列表和滚动性能
- 使用 @Animatable 宏实现自定义动画
- 在 visionOS 上构建 3D 空间布局
- 将 SwiftUI 场景桥接到 UIKit/AppKit 应用
- 实现多项目拖放
- 使用 Chart3D 创建 3D 图表
- 向 visionOS 或 CarPlay 添加 widget
- 向滑块添加自定义刻度线(章节标记、数值指示器)
- 使用
enabledBounds限制滑块选择范围 - 自定义滑块外观(滑块可见性、当前值标签)
- 创建带有模糊效果的粘性安全区域栏
- 在应用内浏览器中打开 URL
- 使用系统样式的关闭和确认按钮
- 应用玻璃按钮样式(iOS 26.1+)
- 控制按钮尺寸行为
- 实现紧凑搜索工具栏
- 调整文本行高或基线间距
系统要求
iOS 26+、iPadOS 26+、macOS Tahoe+、watchOS 26+、visionOS 26+
Liquid Glass 设计系统
详细内容,请参阅 axiom-liquid-glass(设计原则、变体、审查压力)和 axiom-liquid-glass-ref(应用范围采用指南)。本节仅介绍 WWDC 256 特定的 API。
自动采用
使用 iOS 26 SDK 重新编译 — 导航容器、标签栏、工具栏、开关、分段选择器和滑块会自动采用新设计。边框按钮默认为胶囊形状。表单获得 Liquid Glass 背景(删除任何 presentationBackground 自定义)。
工具栏 API(iOS 26)
ToolbarSpacer
.toolbar {
ToolbarItem(placement: .bottomBar) { Button("Archive", systemImage: "archivebox") { } }
ToolbarSpacer(.flexible, placement: .bottomBar) // 将项目推开
ToolbarItem(placement: .bottomBar) { Button("Compose", systemImage: "square.and.pencil") { } }
}
// .fixed 视觉上分离组;.flexible 推开(类似于 HStack 中的 Spacer)
ToolbarItemGroup(视觉分组)
ToolbarItemGroup 中的项目共享一个玻璃背景“药丸”。ToolbarItemPlacement 控制视觉外观:confirmationAction → glassProminent 样式,cancellationAction → 标准玻璃。使用 .sharedBackgroundVisibility(.hidden) 将项目(例如头像)排除在组背景之外。
工具栏变形
将 .toolbar {} 附加到 NavigationStack 内的单个视图上(而不是 NavigationStack 本身)。iOS 26 在 push/pop 期间会在每个视图的工具栏之间变形。使用 toolbar(id:) 并在不同屏幕间使用匹配的 ToolbarItem(id:) 使项目保持稳定(无弹跳):
// MailboxList
.toolbar(id: "main") {
ToolbarItem(id: "filter", placement: .bottomBar) { Button("Filter") { } }
ToolbarSpacer(.flexible, placement: .bottomBar)
ToolbarItem(id: "compose", placement: .bottomBar) { Button("New Message") { } }
}
// MessageList — "filter" 消失(动画移出),"compose" 保持稳定
.toolbar(id: "main") {
ToolbarSpacer(.flexible, placement: .bottomBar)
ToolbarItem(id: "compose", placement: .bottomBar) { Button("New Message") { } }
}
#1 陷阱:将工具栏放在 NavigationStack 上 = 没有东西可以变形。
DefaultToolbarItem
在工具栏布局中重新定位系统提供的项目(如搜索):
DefaultToolbarItem(kind: .search, placement: .bottomBar)
// 替换匹配种类的系统默认位置
在折叠的 NavigationSplitView 侧边栏中使用,以指定在 iPhone 上哪个列显示搜索。在 if #available(iOS 26.0, *) 中包装以向后兼容。
用户可自定义工具栏
toolbar(id:) 允许用户自定义(重新排列、显示/隐藏)。在 iPadOS 上仅 .secondaryAction 项目支持自定义。对可选项目使用 showsByDefault: false。为 macOS 菜单项添加 ToolbarCommands()。
其他工具栏功能
.navigationSubtitle("3 unread")— 标题下方的副标题行.badge(3)在工具栏项目上 — 通知计数- 单色图标渲染 — 减少视觉噪音;为意义着色,而非装饰
- 滚动边缘模糊 — 自动,无需代码
底部对齐搜索
基本搜索 API:请参阅 axiom-swiftui-search-ref。本节仅介绍 iOS 26 的改进。
NavigationSplitView {
List { }.searchable(text: $searchText)
}
// 在 iPhone 上底部对齐,在 iPad 上顶部右侧(自动)
// 使用 placement: .sidebar 以在 iPad 上恢复侧边栏嵌入式搜索
searchToolbarBehavior(.minimize)— 展开时扩展的紧凑搜索Tab(role: .search)— 专用搜索标签页;搜索字段替换标签栏。请参阅 swiftui-nav-ref 第 5.7 节
自定义视图的玻璃效果
Button("To Top", systemImage: "chevron.up") { scrollToTop() }
.padding()
.glassEffect() // 在 iOS 上为自定义控件添加 .interactive
GlassEffectContainer— 当附近有多个玻璃元素时必需(玻璃无法采样玻璃)glassEffectID(_:in:)— 使用命名空间在玻璃元素之间实现流畅的变形过渡- 表单变形 — 使用
.matchedTransitionSource+.navigationTransition(.zoom(...))从按钮变形到表单
按钮 & 控件更改
- 边框按钮默认为胶囊形状(使用
.buttonBorderShape(.roundedRectangle)覆盖) .controlSize(.extraLarge)— 新的特大按钮尺寸- 在容器上使用
.controlSize(.small)— 保留 iOS 26 之前的密度 GlassButtonStyle(.clear/.glass/.tint)— 玻璃按钮变体(iOS 26.1+).buttonSizing(.fit/.stretch/.flexible)— 控制按钮布局行为Button(role: .close)/Button(role: .confirm)— 系统样式的关闭/确认.clipShape(.rect(cornerRadius: 12, style: .containerConcentric))— 圆角同心度- 菜单:图标在左侧边缘,iOS/macOS 一致
滑块增强
iOS 26 添加了自定义刻度线、受限的选择范围、当前值标签和滑块可见性控制。
滑块刻度
核心类型:SliderTick<V>、SliderTickContentForEach、SliderTickBuilder
// 带标签的静态刻度
Slider(value: $value, in: 0...10) {
Text("Rating")
} ticks: {
SliderTick(0) { Text("Min") }
SliderTick(5) { Text("Mid") }
SliderTick(10) { Text("Max") }
}
// 来自集合的动态刻度
SliderTickContentForEach(stops, id: \.self) { value in
SliderTick(value) { Text("\(Int(value))°").font(.caption2) }
}
// 基于步长的刻度(为每个步长值调用)
Slider(value: $volume, in: 0...10, step: 2, label: { Text("Volume") }, tick: { value in
SliderTick(value) { Text("\(Int(value))") }
})
API 约束:SliderTickContentForEach 要求 Data.Element 匹配 SliderTick<V> 值类型。对于自定义结构体,提取数值:chapters.map(\.time) 然后通过 chapters.first(where: { $0.time == time }) 查找标签。
功能完善的滑块
Slider(
value: $rating, in: 0...100,
neutralValue: 50, // 起始点 / 中心值
enabledBounds: 20...80, // 限制可选择范围
label: { Text("Rating") },
currentValueLabel: { Text("\(Int(rating))") },
minimumValueLabel: { Text("0") },
maximumValueLabel: { Text("100") },
ticks: { SliderTick(50) { Text("Mid") } },
onEditingChanged: { editing in print(editing ? "Started" : "Ended") }
)
sliderThumbVisibility
.sliderThumbVisibility(.hidden) — 为媒体进度指示器和极简界面隐藏滑块。选项:.automatic、.visible、.hidden。在 watchOS 上始终可见。
新视图修饰符
safeAreaBar
带有集成渐进模糊的粘性栏:
List { ForEach(1...20, id: \.self) { Text("\($0). Item") } }
.safeAreaBar(edge: .bottom) {
Text("Bottom Action Bar").padding(.vertical, 15)
}
.scrollEdgeEffectStyle(.soft, for: .bottom) // 或 .hard
工作方式类似于 safeAreaInset,但带有模糊效果。内容在下方滚动时,栏保持固定。
onOpenURL 增强
@Environment(\.openURL) var openURL
// openURL(url, prefersInApp: true) — 在类似 SFSafariViewController 的应用内浏览器中打开
// 默认 Link 在 Safari 中打开;prefersInApp 让用户留在应用中
searchToolbarBehavior
请参阅 axiom-swiftui-search-ref 了解基础的 .searchable API。iOS 26 添加:
.searchable(text: $searchText)
.searchToolbarBehavior(.minimize) // 紧凑按钮,点击后展开
另请参阅:.searchPresentationToolbarBehavior(.avoidHidingContent)(iOS 17.1+)在搜索期间保持标题可见。
向后兼容的包装器,适用于目标 iOS 18+26 的应用:
extension View {
@ViewBuilder func minimizedSearch() -> some View {
if #available(iOS 26.0, *) {
self.searchToolbarBehavior(.minimize)
} else { self }
}
}
// 用法
.searchable(text: $searchText)
.minimizedSearch()
工具栏项目的可用性模式:
.toolbar {
if #available(iOS 26.0, *) {
DefaultToolbarItem(kind: .search, placement: .bottomBar)
ToolbarSpacer(.flexible, placement: .bottomBar)
}
ToolbarItem(placement: .bottomBar) {
NewNoteButton()
}
}
.searchable(text: $searchText)
按钮角色、GlassButtonStyle、buttonSizing — 请参阅上方的 Liquid Glass 设计系统部分。
lineHeight(iOS 26)
设置文本行之间的基线到基线距离。比 .lineSpacing() 更直观,后者测量行底部到下一行顶部的距离。
预设
Text("Lorem ipsum...")
.lineHeight(.loose) // 为开放布局增加间距
.lineHeight(.tight) // 为紧凑布局减少间距
.lineHeight(.normal) // 基于点大小倍数的恒定高度
.lineHeight(.variable) // 使用字体指标进行高度计算
精确控制
// 按比例缩放字体大小
Text("Scales with text size")
.lineHeight(.multiple(factor: 2))
// 相对于点大小,固定增加
Text("Point-size relative")
.lineHeight(.leading(increase: 30))
// 绝对固定值 — 不随动态类型缩放
Text("Fixed height")
.lineHeight(.exact(points: 30))
AttributedString 支持
var s = AttributedString("Paragraph\nwith multiple\nlines.")
s.lineHeight = .exact(points: 32)
s.lineHeight = .multiple(factor: 2.5)
s.lineHeight = .loose
与现有 API 的比较
| API | 测量 | 可用性 |
|---|---|---|
.lineHeight() | 基线到基线 | iOS 26+ |
.lineSpacing() | 行底部到下一行顶部 | iOS 13+ |
.font(.body.leading(.tight)) | 字体级的引前预设 | iOS 14+ |
交叉参考 axiom-typography-ref — 完整的排版系统,包括动态类型、字距和国际化
iPad 增强功能
菜单栏
通过下滑菜单访问常用操作
.commands {
TextEditingCommands() // 与 macOS 菜单栏相同的 API
CommandGroup(after: .newItem) {
Button("Add Note") {
addNote()
}
.keyboardShortcut("n", modifiers: [.command, .shift])
}
}
// 在 iPad 上创建菜单栏,当用户下滑时显示
可调整大小的窗口
在 iPad 上流畅调整大小
// 需要迁移:
// 移除 iPadOS 26 中已弃用的属性列表键:
// UIRequiresFullscreen(整个键已弃用,所有值)
// 对于分屏导航,系统根据调整大小期间的可用空间自动显示/隐藏列
NavigationSplitView {
Sidebar()
} detail: {
Detail()
}
// 自动适应调整大小
参考 "Elevate the design of your iPad app"(WWDC 2025)
macOS 窗口增强功能
同步窗口调整大小动画
.windowResizeAnchor(.topLeading) // 调整动画起始位置
// SwiftUI 现在同步内容视图大小变化和窗口调整大小之间的动画
// 非常适合在切换标签页时保持连续性
性能改进
列表性能(macOS 重点)
大型列表的巨大提升
- 在 macOS 上,包含 100,000 个以上项目的列表 加载速度提升 6 倍
- 大型列表 更新速度提升 16 倍
- 更大的列表提升更大
- 改进惠及所有平台(iOS、iPadOS、watchOS)
List(trips) { trip in // 10 万多个项目
TripRow(trip: trip)
}
// 在 macOS 上加载速度提升 6 倍,更新速度提升 16 倍(iOS 26+)
滚动性能
减少丢帧
SwiftUI 改进了 iOS 和 macOS 上用户界面更新的调度。这提高了响应性,并让 SwiftUI 能够做更多工作来为即将到来的帧做准备。总的来说,它降低了应用在高帧率下快速滚动时丢帧的可能性。
嵌套 ScrollView 与惰性栈
照片轮播和多轴滚动
ScrollView(.horizontal) {
LazyHStack {
ForEach(photoSets) { photoSet in
ScrollView(.vertical) {
LazyVStack {
ForEach(photoSet.photos) { photo in
PhotoView(photo: photo)
}
}
}
}
}
}
// 嵌套滚动视图现在使用惰性栈正确延迟加载
// 非常适合构建照片轮播
SwiftUI 性能工具
Xcode 中的新分析工具
可用通道:
- 长视图 body 更新 — 识别昂贵的 body 计算
- 平台视图更新 — 跟踪视图渲染
- Layout — 测量布局传递
- Rendering — 分析绘制性能
- Runtime Profile — 运行时分析
使用方式:在 Xcode 16+ 中选择 Product > Profile,然后选择 SwiftUI Performance 模板。
@Animatable 宏
自定义动画属性
struct MyView: View {
@Animatable var progress: CGFloat = 0
var body: some View {
Circle()
.trim(from: 0, to: progress)
.stroke(.blue, lineWidth: 4)
}
}
// 现在可以在任何视图上使用 @Animatable
// 不需要实现 Animatable 协议
复合值
struct ComplexValue: VectorArithmetic {
var x: Double
var y: Double
}
struct MyView: View {
@Animatable var value: ComplexValue
var body: some View {
Rectangle()
.position(x: value.x, y: value.y)
}
}
3D 空间布局
visionOS 上的三维空间
HStack3D {
Text("Front")
.depth(z: 0)
Text("Middle")
.depth(z: -20)
Text("Back")
.depth(z: -40)
}
// 在 visionOS 上创建深度层次
旋转和变换
Text("Rotated")
.rotation3DEffect(.degrees(45), axis: (x: 0, y: 1, z: 0))
.perspectiveTransform(.init(m11: 1, m12: 0, m13: 0, m14: 0,
m21: 0, m22: 1, m23: 0, m24: 0,
m31: 0, m32: 0, m33: 1, m34: 0,
m41: 0, m42: 0, m43: 0, m44: 1))
场景桥接
将 SwiftUI 场景嵌入 UIKit/AppKit
// UIKit
let hostingController = UIHostingController(rootView: SwiftUIView())
hostingController.sizingOptions = [.preferredContentSize, .sizeThatFits]
// AppKit
let hostingController = NSHostingController(rootView: SwiftUIView())
hostingController.sizingOptions = [.preferredContentSize, .sizeThatFits]
富文本编辑
AttributedString 编辑
@State private var text: AttributedString = "Hello, World!"
var body: some View {
TextEditor(text: $text)
.font(.body)
.foregroundColor(.primary)
}
// 支持运行内文本格式,如 @Font、@ForegroundColor
属性
var attributedText: AttributedString {
var s = AttributedString("Bold and colored")
s.font = .body.bold()
s.foregroundColor = .blue
return s
}
WebView & WebPage
嵌入 WebView
import SwiftUI
import WebKit
struct WebView: UIViewRepresentable {
let url: URL
func makeUIView(context: Context) -> WKWebView {
let webView = WKWebView()
webView.load(URLRequest(url: url))
return webView
}
func updateUIView(_ uiView: WKWebView, context: Context) { }
}
// 用法
WebView(url: URL(string: "https://apple.com")!)
.frame(height: 400)
WebPage (iOS 26)
// iOS 26 中新的 WebPage 视图
WebPage(url: URL(string: "https://apple.com")!)
.frame(height: 400)
// 原生集成,自动处理导航和 cookies
拖放增强
多项目拖放
List(items) { item in
HStack {
Text(item.name)
Spacer()
}
.onDrag {
return NSItemProvider(object: item.id.uuidString as NSString)
}
}
.onInsert(of: ["public.text"]) { index, providers in
// 处理 drop
}
外部拖放
List(items) { item in
Text(item.name)
.onDrag {
return NSItemProvider(object: item.name as NSString)
}
.onDrop(of: ["public.plain-text"], delegate: DropDelegate())
}
3D 图表
Chart3D
Chart3D {
BarMark3D(x: "Category", y: "Value")
.foregroundStyle(by: .value("Category", "A"))
}
.frame(width: 300, height: 300)
// 在 visionOS 上创建 3D 条形图
Widget 增强
visionOS Widget
struct MyWidget: Widget {
var body: some WidgetConfiguration {
StaticConfiguration(kind: "MyWidget", provider: Provider()) { entry in
MyWidgetEntryView(entry: entry)
}
.supportedFamilies([.systemSmall, .systemMedium, .systemLarge])
}
}
// 在 visionOS 上,widget 显示在 3D 空间中
CarPlay Widget
struct CarPlayWidget: Widget {
var body: some WidgetConfiguration {
StaticConfiguration(kind: "CarPlayWidget", provider: Provider()) { entry in
CarPlayWidgetView(entry: entry)
}
.supportedFamilies([.carPlay])
}
}
其他增强功能
自定义滑块值标签
Slider(value: $value, in: 0...100,
currentValueLabel: { Text("\(Int(value))%").font(.caption) },
minimumValueLabel: { Text("0%") },
maximumValueLabel: { Text("100%") }
)
受限滑块范围
Slider(value: $value, in: 0...100, enabledBounds: 20...80)
// 用户只能选择 20 到 80 之间的值
粘性安全区域栏
List { ForEach(1...50, id: \.self) { Text("Item \($0)") } }
.safeAreaBar(edge: .bottom) {
HStack {
Button("Action 1") { }
Spacer()
Button("Action 2") { }
}
.padding()
.background(.ultraThinMaterial)
}
应用内浏览器
@Environment(\.openURL) var openURL
Button("Open Website") {
openURL(URL(string: "https://apple.com")!, prefersInApp: true)
}
系统样式按钮
Button(role: .close) { dismiss() } label: { Label("Close", systemImage: "xmark.circle.fill") }
Button(role: .confirm) { confirm() } label: { Label("Confirm", systemImage: "checkmark.circle.fill") }