# 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 * 向滑块添加自定义刻度线（章节标记、值指示器） * 使用“enabledBounds”限制滑块选择范围 * 自定义滑块外观（拇指可见性、当前值标签） * 创建具有模糊效果的粘性安全区域栏 * 在应用内浏览器中打开 URL * 使用系统风格的关闭和确认按钮 * 应用玻璃按钮样式（iOS 26.1+） * 控制按钮大小行为 * 实现紧凑的搜索工具栏 * 调整文本的行高或基线间距 ## 系统要求 #### iOS 26+、iPadOS 26+、macOS Tahoe+、watchOS 26+、visionOS 26+ ** ** ## 液态玻璃设计系统 **有关全面覆盖**，请参阅“axiom-liquid-glass”（设计原则、变体、审核压力）和“axiom-liquid-glass-ref”（应用程序范围采用指南）。本节仅涵盖 WWDC 256 特定的 API。 ### 自动采用使用 iOS 26 SDK 重新编译 - 导航容器、选项卡栏、工具栏、切换开关、分段选择器和滑块自动采用新设计。带边框的按钮默认为胶囊形状。工作表获得液体玻璃背景（删除任何“presentationBackground”自定义）。 ### 工具栏 API (iOS 26) #### 工具栏间隔符 .工具栏{ 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 在推送/弹出期间在每个视图工具栏之间变形。在屏幕上使用“toolbar(id:)”和匹配的“ToolbarItem(id:)”来获得应保持稳定（无弹跳）的项目： // 邮箱列表 .toolbar(id: "主") { ToolbarItem(id: "filter", 位置: .bottomBar) { Button("Filter") { } } ToolbarSpacer(.flexible, 位置: .bottomBar) ToolbarItem(id: "compose",placement: .bottomBar) { Button("新消息") { } } } // MessageList —“filter”不存在（动画消失），“compose”保持稳定 .toolbar(id: "主") { ToolbarSpacer(.flexible, 位置: .bottomBar) ToolbarItem(id: "compose",placement: .bottomBar) { Button("新消息") { } } } **#1 陷阱**：NavigationStack 上的工具栏 = 之间没有任何可变形的内容。 #### 默认工具栏项在工具栏布局中重新定位系统提供的项目（例如搜索）： DefaultToolbarItem（种类：.search，位置：.bottomBar） // 替换系统默认的匹配种类放置在折叠的“NavigationSplitView”侧边栏中使用来指定哪一列在 iPhone 上显示搜索。包裹在 `if #available(iOS 26.0, *)` 中以实现向后兼容性。 #### 用户可定制的工具栏 `toolbar(id:)` 允许用户自定义（重新排列、显示/隐藏）。只有“.secondaryAction”项目支持 iPadOS 上的自定义。对可选项目使用“showsByDefault: false”。为 macOS 菜单项添加 `ToolbarCommands()`。 #### 其他工具栏功能 * `.navigationSubtitle("3 unread")` — 标题下方的第二行 * 工具栏项上的 `.badge(3)` — 通知计数 * 单色图标渲染——减少视觉噪音；色彩是为了意义，而不是装饰 * 滚动边缘模糊——自动，无需代码 ### 底部对齐搜索 **基础搜索 API** ：请参阅 `axiom-swiftui-search-ref`。本节仅涵盖 iOS 26 改进。导航分割视图{ 列表 { }.searchable(text: $searchText) } // iPhone 上底部对齐，iPad 上顶部尾随（自动） // 使用placement: .sidebar恢复iPad上的侧边栏嵌入搜索 * `searchToolbarBehavior(.minimize)` — 点击即可扩展的紧凑搜索 * `Tab(role: .search)` — 专用搜索选项卡；搜索字段取代了标签栏。请参阅 swiftui-nav-ref 第 5.7 节 ### 自定义视图的玻璃效果按钮（“到顶部”，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`、`SliderTickContentForEach`、`SliderTickBuilder` // 带标签的静态刻度滑块（值：$值，在：0...10）{ 文本（“评分”） } 勾选：{ SliderTick(0) { 文本("最小") } SliderTick(5) { 文本("中") } SliderTick(10) { 文本(“最大”) } } // 来自集合的动态报价 SliderTickContentForEach(stops, id: \.self) { 中的值 SliderTick(value) { Text("\(Int(value))°").font(.caption2) } } // 基于步长的刻度（针对每个步长值调用） Slider(值: $volume, in: 0...10, 步骤: 2, label: { Text("Volume") }, 刻度线: { value in SliderTick(值) { Text("\(Int(value))") } }) **API 约束**： `SliderTickContentForEach` 要求 `Data.Element` 匹配 `SliderTick` 值类型。对于自定义结构，提取数值：“chapters.map(\.time)”，然后通过“chapters.first(where: { $0.time == time })”查找标签。 ### 全功能滑块滑块（值：$评级，单位：0...100， neutralValue: 50, // 起点/中心值 enabledBounds: 20...80, // 限制可选择范围标签：{文本（“评级”）}， currentValueLabel: { Text("\(Int(评级))") }, 最小值标签：{文本（“0”）}，最大值标签: { Text("100") }, 刻度：{ SliderTick(50) { Text("Mid") } }, onEditingChanged: { 在 print 中编辑(编辑 ? "开始" : "结束") } ） ### sliderThumbVisibility `.sliderThumbVisibility(.hidden)` — 隐藏媒体进度指示器和最小 UI 的缩略图。选项：`.automatic`、`.visible`、`.hidden`。在 watchOS 上始终可见。 ** ** ## 新的视图修饰符 ### 安全区域栏具有集成渐进式模糊功能的粘性条：列表 { ForEach(1...20, id: \.self) { Text("\($0).Item") } } .safeAreaBar(边缘: .bottom) { Text("底部操作栏").padding(.vertical, 15) } .scrollEdgeEffectStyle(.soft, for: .bottom) // 或 .hard 与“safeAreaInset”类似，但有模糊效果。栏保持固定，而内容在下方滚动。 ### onOpenURL 增强 @Environment(\.openURL) var openURL // openURL(url, PreferredInApp: true) — 在 SFSafariViewController 风格的应用内浏览器中打开 // 默认链接在 Safari 中打开； PreferredInApp 让用户留在您的应用中 ### searchToolbarBehavior 有关基础的“.searchable” API，请参阅“axiom-swiftui-search-ref”。 iOS 26 增加了： .searchable(文本：$searchText) .searchToolbarBehavior(.minimize) // 紧凑按钮，点击时展开另外：`.searchPresentationToolbarBehavior(.avoidHidingContent)` (iOS 17.1+) 在搜索过程中保持标题可见。 **向后兼容的包装**，适用于面向 iOS 18+26 的应用程序：扩展视图 { @ViewBuilder func minimindSearch() -> 一些视图 { 如果 #available(iOS 26.0, *) { self.searchToolbarBehavior(.minimize) } 否则 { 自我 } } } // 用法 .searchable(文本：$searchText) .minimizedSearch() **工具栏项目的可用性模式**： .工具栏{ 如果 #available(iOS 26.0, *) { DefaultToolbarItem（种类：.search，位置：.bottomBar） ToolbarSpacer(.flexible, 位置: .bottomBar) } ToolbarItem(放置：.bottomBar) { 新笔记按钮() } } .searchable(文本：$searchText) **按钮角色、GlassButtonStyle、buttonSizing** — 请参阅上面的液态玻璃设计系统部分。 ### 行高 (iOS 26) 设置文本行之间的基线到基线距离。比测量行底部到下一行顶部的“.lineSpacing()”更直观。 #### 预设 Text("Lorem ipsum...") .lineHeight(.loose) // 增加开放布局的间距 .lineHeight(.tight) // 减少间距以实现紧凑布局 .lineHeight(.normal) // 基于点大小倍数的恒定高度 .lineHeight(.variable) // 使用字体规格进行高度计算 #### 精确控制 // 根据字体大小按比例缩放 Text("随文字大小缩放") .lineHeight(.multiple(因子：2)) // 相对于点大小固定增加 Text("相对点大小") .lineHeight(.leading(增加: 30)) // 绝对固定值 - 不随动态类型缩放文本（“固定高度”） .lineHeight(.exact(点: 30)) #### 属性字符串支持 var s = AttributedString("段落\n有多行\n。") s.lineHeight = .exact(点: 32) s.lineHeight = .multiple(系数: 2.5) s.lineHeight = .loose #### 与现有 API 的比较应用程序接口 |措施|可用 ---|---|--- `.lineHeight()` |基线到基线| iOS 26+ `.lineSpacing()` |行底到下一行顶部| iOS 13+ `.font(.body.leading(.tight))` |字体级行距预设 | iOS 14+ **交叉引用** `axiom-typography-ref` — 完整的排版系统，包括动态类型、跟踪和国际化 ** ** ## iPad 增强功能 ### 菜单栏 #### 通过向下滑动菜单访问常用操作 .命令{ TextEditingCommands() // 与 macOS 菜单栏相同的 API CommandGroup（之后：.newItem）{ 按钮（“添加注释”）{ 添加注释() } .keyboardShortcut("n", 修饰符: [.command, .shift]) } } // 当人们向下滑动时在 iPad 上创建菜单栏 ### 可调整大小的窗口 #### iPad 上的流体调整大小 // 需要迁移： // 删除 iPadOS 26 中已弃用的属性列表键： // UIRequiresFullscreen（整个键已弃用，所有值） // 对于分屏导航，系统自动显示/隐藏列 // 基于调整大小期间的可用空间导航分割视图{ 侧边栏() } 详细信息：{ 详情() } // 适应自动调整大小 **参考**“提升 iPad 应用程序的设计”（WWDC 2025） ** ** ## macOS 窗口增强功能 ### 同步窗口调整大小动画 .windowResizeAnchor(.topLeading) // 定制动画起始位置 // SwiftUI 现在在内容视图大小更改之间同步动画 // 和窗口大小调整 - 非常适合在切换选项卡时保持连续性 ** ** ## 性能改进 ### 列表性能（macOS 焦点） #### 大型列表的巨大收益 * **macOS 上 100,000 多个项目列表的加载速度加快 6 倍** * **大型列表的更新速度加快 16 倍** * 更大的列表可以获得更大的收益 * 改进使所有平台受益（iOS、iPadOS、watchOS） List(trips) { trip in // 100k+ 项目 TripRow(行程：行程) } // 在 macOS (iOS 26+) 上加载速度提高 6 倍，更新速度提高 16 倍 ### 滚动性能 #### 减少丢帧 SwiftUI 改进了 iOS 和 macOS 上用户界面更新的安排。这提高了响应能力，并让 SwiftUI 可以做更多的工作来为即将到来的帧做好准备。总而言之，它减少了应用程序在高帧速率快速滚动时丢帧的可能性。 ### 带有惰性堆栈的嵌套 ScrollView #### 照片轮播和多轴滚动滚动视图（.水平）{ 惰性HStack { ForEach(photoSets) { photoSet in ScrollView(.vertical) { LazyVStack { ForEach(photoSet.photos) { 照片中照片查看（照片：照片） } } } } } } // 嵌套滚动视图现在可以使用惰性堆栈正确延迟加载 // 非常适合构建照片轮播 ### SwiftUI 性能工具 #### Xcode 中的新分析工具可用车道： * **长视身体更新** - 识别昂贵的身体计算 * **平台视图更新** — 跟踪 UIKit/AppKit 桥接性能 * 其他性能问题领域 **参考**“使用工具优化 SwiftUI 性能”(WWDC 2025) **交叉参考** [SwiftUI 性能]() — 掌握 SwiftUI 工具 ** ** ## Swift 并发集成 ### 编译时数据竞争安全 @Observable 类 TripStore { var 行程：[行程] = [] func loadTrips() 异步 { trips = 等待 TripService.fetchTrips() // Swift 6 在编译时验证数据竞争安全 } } **好处** 在并发代码影响您的应用程序之前找到它们 #### 参考文献 *“拥抱 Swift 并发”（WWDC 2025） *“探索 SwiftUI 中的并发性”（WWDC 2025） **交叉引用** [Swift Concurrency]() — Swift 6 严格并发模式 ** ** ## @Animatable 宏 ### 概述通过自动合成“animatableData”属性来简化自定义动画。 #### 之前（@Animatable 宏）结构 HikingRouteShape: 形状 { var startPoint：CGPoint var endPoint：CGPoint 变量海拔：双 var DrawingDirection: Bool // 不想为此设置动画 // 繁琐的手动animableData声明 var animatableData: AnimatablePair> { 得到{ AnimatablePair(startPoint.animatableData, AnimatablePair(海拔, endPoint.animatableData)) } 设置{ startPoint.animatableData = newValue.first 高程 = newValue.second.first endPoint.animatableData = newValue.second.second } } } #### 之后（@Animatable 宏） @动画结构 HikingRouteShape: 形状 { var startPoint：CGPoint var endPoint：CGPoint 变量海拔：双 @AnimatableIgnored var DrawingDirection: Bool // 从动画中排除 // animableData 自动合成！ } #### 主要优点 * 删除手动`animatableData`属性 * 使用`@AnimatableIgnored`作为要排除的属性 * SwiftUI自动合成动画数据 **交叉引用** SwiftUI Animation (swiftui-animation-ref 技能) — 全面的动画指南，涵盖 VectorArithmetic、Animatable 协议、@Animatable 宏、动画类型、事务系统和性能优化 ** ** ## 3D 空间布局 (visionOS) ### 3D 对齐 #### 基于深度的布局结构 SunPositionView: 视图 { @State private var timeOfDay: Double = 12.0 var body: 一些视图 { 徒步路线视图() .overlay(对齐方式：sunAlignment) { 太阳视图() .spatialOverlay(对齐方式：sunAlignment) } } var sunAlignment: Alignment3D { // 根据一天中的时间在 3D 空间中对齐太阳 3D 对齐( 水平：.center, 垂直：.顶部，深度：.back ） } } ### 可操作修改器 #### 交互式 3D 对象 Model3D（名称：“水瓶”） .manipulable() // 人们可以拾取并移动物体 ### 表面捕捉 API @Environment(\.surfaceSnappingInfo) var snappingInfo: SurfaceSnappingInfo var body: 一些视图 { VStackLayout().深度对齐(.center) { Model3D（名称：“水瓶”） .manipulable() 基座() .opacity(snappingInfo.classification == .table ? 1.0 : 0.0) } } #### 参考文献 *“认识 SwiftUI 空间布局”（WWDC 2025） *“在visionOS中使用SwiftUI设置场景”（WWDC 2025） *“visionOS 的新增功能”（WWDC 2025） ** ** ## 场景桥接 ### 概述场景桥接允许您的 UIKit 和 AppKit 生命周期应用程序与 SwiftUI 场景进行互操作。应用程序可以使用它打开仅限 SwiftUI 的场景类型，或直接从 UIKit 或 AppKit 代码使用 SwiftUI 独有的功能。 ### 支持的场景类型 #### 从 UIKit/AppKit 应用程序中，您现在可以使用 * `MenuBarExtra` (macOS) *“沉浸式空间”（visionOS） * `RemoteImmersiveSpace` (macOS → Vision Pro) *“辅助访问”（iOS 26） ### 场景修改器与场景修改器一起使用，例如： * `.windowStyle()` * `.immersiveEnvironmentBehavior()` ### 远程沉浸式空间 #### Mac 应用程序在 Vision Pro 上渲染立体内容 // 在你的 macOS 应用程序中 @主要结构 MyMacApp: 应用程序 { var body: 一些场景 { 窗口组{ 内容视图() } RemoteImmersiveSpace（id：“stereoView”）{ // 在 Apple Vision Pro 上渲染立体内容 // 使用 CompositorServices } } } #### 特点 * Mac 应用程序在 Vision Pro 上渲染立体内容 * 支持悬停效果和输入事件 * 使用 CompositorServices 和 Metal **参考**“沉浸式应用程序 Metal 渲染的新增功能”（WWDC 2025） ### 辅助访问场景 #### 针对认知障碍用户的特殊模式 @主要结构我的应用程序：应用程序{ var body: 一些场景 { 窗口组{ 内容视图() } 辅助访问场景{ SimplifiedUI() // iPhone 处于 AssistiveAccess 模式时显示的 UI } } } **参考**“自定义您的应用以实现辅助访问”(WWDC 2025) ** ** ## AppKit 集成增强 ### AppKit 中的 SwiftUI 工作表 // 在 AppKit 表中显示 SwiftUI 视图让 HostingController = NSHostingController(rootView: SwiftUISettingsView()) PresentAsSheet（托管控制器） // 非常适合增量 SwiftUI 采用 ### NSGestureRecognizerRepresentable // 将 AppKit 手势桥接到 SwiftUI 结构 AppKitPanGesture: NSGestureRecognizerRepresentable { func makeNSGestureRecognizer(context: Context) -> NSPanGestureRecognizer { NSPanGestureRecognizer() } func updateNSGestureRecognizer(_ 识别器: NSPanGestureRecognizer, context: Context) { // 更新配置 } } ### Interface Builder 中的 NSHostingView NSHostingView 现在可以直接在 Interface Builder 中使用，以逐步采用 SwiftUI。 ** ** ## RealityKit 集成 ### 可观察实体 @Observable 类现实实体{ 变量位置：SIMD3 变量旋转：simd_quatf } 结构MyView：视图{ @State private var实体= RealityEntity() var body: 一些视图 { // SwiftUI 视图自动观察变化 Text("位置：\(entity.position.x)") } } ### 演示组件直接从 RealityKit 实体呈现 SwiftUI 弹出窗口、警报和工作表。 // 显示来自 RealityKit 实体的 SwiftUI 弹出窗口让弹出窗口 = 实体() mapEntity.addChild(弹出窗口) popover.components[PresentationComponent.self] =PresentationComponent( isPresented: $popoverPresented, 配置：.popover(arrowEdge: .bottom), 内容：详情查看() ） ### 其他改进 * `ViewAttachmentComponent` — 将 SwiftUI 视图添加到实体 * `GestureComponent` — 实体触摸和手势响应 * 增强坐标转换API * 同步动画、绑定组件 * RealityView 的新尺寸调整行为 **参考** “更好地结合：SwiftUI 和 RealityKit”（WWDC 2025） ** ** ## Web 视图和网页 ### 概述 WebKit 现在提供完整的 SwiftUI API 用于嵌入 Web 内容，无需下拉至 UIKit。 ### 网页视图 #### 显示网页内容导入WebKit 结构 ArticleView: 视图 { 让文章URL: URL var body: 一些视图 { WebView(url: 文章URL) } } ### 网页（可观察模型） #### 与网页内容的丰富交互导入WebKit 结构 InAppBrowser: 查看 { @State private var page = WebPage() var body: 一些视图 { 虚拟堆栈{ 文本（页面.标题？“正在加载...”）网页视图（页面） .ignoresSafeArea() .onAppear { page.load(URLRequest(url: 文章URL)) } HStack { 按钮(“返回”) { page.goBack() } .disabled(!page.canGoBack) 按钮("前进") { page.goForward() } .disabled(!page.canGoForward) } } } } #### 网页功能 * 程序化导航（`goBack()`、`goForward()`） * 访问页面属性（`title`、`url`、`canGoBack`、`canGoForward`） * Observable — SwiftUI 视图自动更新 **tvOS**：WebView 和网页**在 tvOS** 上不可用。 tvOS 根本没有 WKWebView。对于 tvOS 上的网页内容解析，请使用 JavaScriptCore。请参阅“axiom-tvos”以获取替代方案。 ### 高级 WebKit 功能 * 自定义用户代理 * JavaScript执行 * 自定义 URL 方案 * 还有更多 **参考** “认识 SwiftUI 的 WebKit”（WWDC 2025） ** ** ## 带有 AttributedString 的文本编辑器 ### 概述 SwiftUI 对富文本编辑的新支持非常适合评论照片等体验。 TextView 现在支持 AttributedString！ **注意** WWDC 记录使用“TextView”作为编辑语言。实际的 SwiftUI API 是“TextEditor”，它现在支持“AttributedString”绑定以进行富文本编辑。 ### 富文本编辑结构CommentView：查看{ @State private var comment = AttributedString("输入您的评论") var body: 一些视图 { 文本编辑器（文本：$comment） // 包含内置文本格式控件 // 用户可以应用粗体、斜体、下划线等。 } } #### 特点 * 内置文本格式控件（粗体、斜体、下划线、颜色等） * 绑定到 `AttributedString` 保留格式 * 带有格式选项的自动工具栏 ### 高级 AttributedString 功能 #### 自定义选项 * 段落样式 * 属性转换 * 限制用户可以应用哪些属性 **参考**“使用 AttributedString 在 SwiftUI 中打造丰富的文本体验”(WWDC 2025) **交叉引用** App Intents 集成（app-intents-ref 技能） - Apple Intelligence 使用模型操作的 AttributedString ** ** ## 拖放增强功能 ### 多个项目拖动 #### 根据选择拖动多个项目结构 PhotoGrid: 查看 { @State private var selectedPhotos: [Photo.ID] = [] var body: 一些视图 { 滚动视图{ LazyVGrid（列：gridColumns）{ ForEach(model.photos) { 照片中查看（照片：照片） .draggable(containerItemID: photo.id) } } } .dragContainer（for：Photo.self，选择：selectedPhotos）{ DraggedIDs in 照片（ids：draggedIDs） } } } **关键 API** ： * `.draggable(containerItemID:containerNamespace:)` 将每个项目标记为拖动容器的一部分（命名空间默认为 `nil`） * `.dragContainer(for:selection:)` 在发生放置时延迟提供键入的项目 ### 拖动配置 #### 自定义支持的操作 .dragConfiguration(DragConfiguration(allowMove: false, allowedDelete: true)) ### 观察拖动事件 .onDragSessionUpdated { 会话中让 ids = session.draggedItemIDs(for: Photo.ID.self) if session.phase == .ending(.delete) { 垃圾（ID）删除照片（id） } } ### 拖动预览阵型 .dragPreviewsFormation(.stack) // 项目很好地堆叠在一起 // 其他阵型： // - .default // - .grid // - .stack 将所有修饰符（`.dragContainer`、`.dragConfiguration`、`.dragPreviewsFormation`、`.onDragSessionUpdated`）组合在同一个滚动视图上，以获得完整的多项目拖动体验。 ** ** ## 3D 图表 ### 概述 Swift Charts 支持使用“Chart3D”进行三维绘图。关键组件：`Chart3D`（容器）、`SurfacePlot`（连续曲面）、`Chart3DPose`（相机控制）、`Chart3DSurfaceStyle`（曲面外观）。 ### Chart3D 容器导入图表 Chart3D { SurfacePlot(x: "x", y: "y", z: "z") { x, y in 正弦(x) * 余弦(y) } .foregroundStyle(渐变(颜色: [.orange, .pink])) } .chartXScale（域：-3...3） .chartYScale（域：-3...3） .chartZScale（域：-3...3） `Chart3D` 也接受数据集合： Chart3D(dataPoints) { 点 // 每个数据点的 3D 标记 } ### 曲面图根据将 (x, y) 映射到 z 值的数学函数渲染连续曲面。 SurfacePlot(x: "X 轴", y: "Y 轴", z: "Z 轴") { x, y in sin(sqrt(x * x + y * y)) } #### 表面造型 SurfacePlot(x: "X", y: "Y", z: "Z") { x, y in sin(x) * cos(y) } .foregroundStyle(.blue) // 纯色 .roughness(0.3) // 0 = 平滑，1 = 粗糙 // 基于高度的着色（颜色映射到 z 值） .foregroundStyle(Chart3DSurfaceStyle.heightBased(yRange: -1.0...1.0)) // 自定义渐变映射到高度 .foregroundStyle(Chart3DSurfaceStyle.heightBased( 渐变（颜色：[.蓝色，.绿色，.黄色，.红色]）， y范围：-1.0...1.0 ））可用的表面样式：“.heightBased”（按 z 值颜色）、“.normalBased”（按表面法线方向颜色）。 #### 多个表面 Chart3D { SurfacePlot(x: "X", y: "Y", z: "Z") { x, y in sin(x) * cos(y) } SurfacePlot(x: "X", y: "Y", z: "Z") { x, y in cos(x) * sin(y) + 2 } } ### Chart3Dpose（相机控制）控制视角。作为静态定位的值传递，或交互式旋转的绑定。 @State私有变量chartPose：Chart3DPose = .default Chart3D { /* ... */ } .chart3DPose(chartPose) // 静态 — 只读 .chart3DPose($chartPose) // 绑定 — 启用拖动旋转预定义姿势：`.default`、`.front`、`.back`、`.top`、`.bottom`、`.left`、`.right` 具有特定角度的自定义姿势： Chart3DPose（方位角：.度（45），倾角：.度（30））在姿势之间设置动画：按钮（“顶视图”）{ withAnimation { ChartPose = .top } } ### Chart3DCameraProjection 控制如何将 3D 深度投影到 2D。 Chart3D { /* ... */ } .chart3DCameraProjection(.perspective) // 对象随距离缩小 .chart3DCameraProjection(.orthographic) // 无论深度如何，对象都保持大小 .chart3DCameraProjection(.automatic) // 系统决定 ### Z 轴修改器所有现有的图表轴修改器都有 z 轴等效项： * `.chartZScale(domain:)` — 设置 z 轴范围 * `.chartZAxis()` — 配置 z 轴标签和网格线 **参考**“将 Swift 图表带入三维”（WWDC 2025） ** ** ## 小部件和控件 ### watchOS 和 macOS 上的控件 #### watchOS 26 结构FavoriteLocationControl：ControlWidget { var body: 一些 ControlWidgetConfiguration { StaticControlConfiguration（种类：“最喜欢的位置”）{ ControlWidgetButton（操作：MarkFavoriteIntent（））{ Label("标记为收藏", systemImage: "star") } } } } // 从表盘或快捷方式访问 #### macOS 控件现在显示在 Mac 上的控制中心中。 ### VisionOS 上的小部件 #### 细节定制级别结构 CountdownWidget: 小部件 { var body: 一些 WidgetConfiguration { StaticConfiguration(kind: "Countdown") { 条目倒计时视图（条目：条目） } } } 结构 PhotoCountdownView: 查看 { @Environment(\.levelOfDetail) var levelOfDetail: LevelOfDetail var body: 一些视图 { 切换细节级别{ 案例.默认： centrecentphotosview() // 关闭时的完整详细信息案例.简化： CountdownView() // 距离较远时简化默认：倒计时视图() } } } ### CarPlay 上的小部件 #### CarPlay 上的现场活动实时活动现在显示在 CarPlay 显示屏上，以便在驾驶时查看信息。 ### 其他小部件功能 * 基于推送的更新API * watchOS 的新相关 API **参考**“小部件的新增功能”（WWDC 2025） ** ** ## 迁移清单 ### 已弃用的 API #### ❌ 在 iPadOS 26 中删除 UI需要全屏应用程序必须支持 iPad 上可调整大小的窗口。 ### 自动采用（仅重新编译） ✅ 用于导航、选项卡栏、工具栏的液态玻璃设计 ✅ iPhone 上的底部对齐搜索 ✅ 列表性能改进（6 倍加载，16 倍更新） ✅ 滚动性能改进 ✅ 系统控件（切换、选择器、滑块）新外观 ✅ 有边框按钮默认为胶囊形状 ✅ 更新了控件高度（在 macOS 上稍高） ✅ 工具栏中的单色图标渲染 ✅ 菜单：图标位于前缘，在 iOS 和 macOS 上保持一致 ✅ 表格自动变形出对话框✅ 在系统工具栏下滚动边缘模糊/淡入淡出 ### 审计项目（删除旧的自定义） ⚠️从工作表中删除“presentationBackground”（让液态玻璃材质发光）⚠️删除工具栏区域后面的额外背景/变暗效果⚠️删除硬编码的控件高度（使用自动调整大小）⚠️将节标题更新为标题样式大写（不再自动大写） ### 手动采用（代码更改） 🔧 工具栏间隔符 (`.fixed`) 🔧 工具栏中的有色突出按钮 🔧 自定义视图的玻璃效果 (`.glassEffect()`) 🔧 `glassEffectID` 用于玻璃元素之间的变形过渡 🔧 `GlassEffectContainer` 用于多个附近的玻璃元素 🔧 `sharedBackgroundVisibility(.hidden)` 用于从组背景中删除工具栏项目🔧 从按钮变形的工作表 (`navigationZoomTransition`) 🔧 搜索选项卡角色 (`Tab(role: .search)`) 🔧 紧凑搜索工具栏 (`.searchToolbarBehavior(.minimize)`) 🔧 超大按钮 (`.controlSize(.extraLarge)`) 🔧 同心矩形形状 (`.containerConcentric`) 🔧 iPad 菜单栏 (`.commands`) 🔧 窗口调整大小锚点 (`.windowResizeAnchor()`) 🔧 用于自定义形状/修改器的 @Animatable 宏 🔧 用于网页内容的 WebView 🔧 具有 AttributedString 绑定的 TextEditor 🔧 使用 `.dragContainer` 增强拖放功能 🔧 滑块刻度 (`SliderTick`, `SliderTickContentForEach`) 🔧 滑块拇指可见性 (`.sliderThumbVisibility()`) 🔧 带模糊的安全区域栏 (`.safeAreaBar()` \+ `.scrollEdgeEffectStyle()`) 🔧 应用内 URL 打开 (`openURL(url, PreferredInApp: true)`) 🔧 关闭并确认按钮角色 (`Button(role: .close)`) 🔧 玻璃按钮样式 (`GlassButtonStyle` — iOS 26.1+) 🔧 按钮大小控制 (`.buttonSizing()`) 🔧 工具栏变形过渡（NavigationStack 内的每个视图 `.toolbar {}`） 🔧 工具栏中系统组件的 DefaultToolbarItem 🔧 稳定的工具栏项目 (`toolbar(id:)` ，具有匹配的 ID屏幕） 🔧 用户可自定义的工具栏（`toolbar(id:)` 和 `CustomizedToolbarContent`） 🔧 行高控制（`.lineHeight()` — 基线到基线的距离） 🔧 选项卡栏最小化 (`.tabBarMinimizeBehavior(.onScrollDown)`) 🔧 选项卡视图底部附件 (`.tabViewBottomAccessory(isEnabled:content:)` — iOS 26.1+) ** ** ## 最佳实践 * **性能**：使用新的 SwiftUI Instrument 进行配置；在嵌套的 ScrollView 中使用惰性堆栈；信任自动列表性能改进 * **Liquid Glass** ：先重新编译并测试；使用工具栏间隔符；将`.toolbar {}`附加到各个视图（不是NavigationStack）；从工作表中删除“presentationBackground”；对附近的玻璃元素使用“GlassEffectContainer” * **布局** ：使用 `.safeAreaPadding()` 进行边到边（而不是 `.padding()`）。请参阅 `axiom-swiftui-layout-ref` 获取完整指南 * **富文本** : 将`AttributedString`绑定到`TextEditor`；限制用户体验的属性 * **空间 (visionOS)** ：使用 `Alignment3D` 作为深度； `.manipulable()` 仅在有意义的地方 ** ** ## 故障排除症状|修复 ---|--- 更新到 iOS 26 SDK 后的旧设计 |全新构建 (Shift-Cmd-K)，针对 iOS 26 SDK 进行重建，检查部署目标 iPhone 上搜索仍居首位 |将 `.searchable` 放在 `NavigationSplitView` 上，而不是直接放在 `List` 上 @Animatable“不符合”|所有属性必须是“VectorArithmetic”或标记为“@AnimatableIgnored” 富文本格式在 TextEditor 中丢失 |绑定 `AttributedString`，而不是 `String` 拖动删除不起作用|启用 `.dragConfiguration(allowDelete: true)` 并观察 `.onDragSessionUpdated` SliderTickContentForEach 无法编译 |迭代数值（`chapters.map(\.time)`），而不是自定义结构 - 请参阅滑块部分工具栏在导航期间不会变形 |将 `.toolbar {}` 从 NavigationStack 移动到其中的每个视图 - 请参阅 Liquid Glass 部分 ** ** ## 资源 **WWDC** ：2025-256、2025-278（小部件中的新增功能）、2025-287（了解 SwiftUI 的 WebKit）、2025-310（使用工具优化 SwiftUI 性能）、2025-323（使用新设计构建 SwiftUI 应用程序）、2025-325（将 Swift Charts 带到第三个版本）维度），2025-341（使用 AttributedString 在 SwiftUI 中打造丰富的文本体验） **文档**：/swiftui、/swiftui/defaulttoolbaritem、/swiftui/toolbarspacer、/swiftui/searchtoolbarbehavior、/swiftui/view/toolbar(id:content:)、/swiftui/view/tabbarminimizebehavior(_:)、/swiftui/view/tabviewbottomaccessory(isenabled:content:)、/swiftui/slider、/swiftui/slidertick、 /swiftui/slidertickcontentforeach、/webkit、/foundation/attributedstring、/charts、/charts/chart3d、/charts/surfaceplot、/charts/chart3dpose、/charts/chart3dcameraprojection、/charts/chart3dsurfacestyle、/realitykit/presentationcomponent **技能**：axiom-swiftui-性能、axiom-liquid-glass、axiom-swift-concurrency、axiom-app-intents-ref、axiom-swiftui-search-ref ** ** **主要来源** WWDC 2025-256“SwiftUI 中的新增功能”。来自 2025-323（使用新设计构建 SwiftUI 应用程序）、2025-287（认识 SwiftUI 的 WebKit）和 Apple 文档的其他内容。 **版本** iOS 26+、iPadOS 26+、macOS Tahoe+、watchOS 26+、visionOS 26+

Axiom Swiftui 26 参考

包含技能