6 导航 on 编程那些事儿

6.1 理解导航栈

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/understanding-the-navigation-stack

6.1 理解导航栈

了解导航栈、导航链接，以及如何在应用结构中管理导航类型。

概述

NavigationStack 是应用导航结构的容器。用导航栈可以在根视图之上呈现一叠视图。

NavigationStack 通过其构造器的路径参数把状态暴露给应用。要创建一个可以控制、或可以跟踪栈上视图的带路径导航栈，请使用 NavigationPath，或者指向一个包含 Hashable 元素的 RandomAccessCollection 与 RangeReplaceableCollection 的 Binding。

6.2 为 SwiftUI 应用引入健壮的导航结构

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/bringing-robust-navigation-structure-to-your-swiftui-app

6.2 为 SwiftUI 应用引入健壮的导航结构

使用导航链接、栈、目标和路径，为所有平台提供流畅的体验，并支持深度链接、状态恢复等行为。

概述

注意：这个示例代码项目与 WWDC22 的 10054：SwiftUI 导航实战手册场次相关。

6.3 迁移到新的导航类型

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/migrating-to-new-navigation-types

6.3 迁移到新的导航类型

用导航栈和导航分栏视图替换导航视图，改善应用的导航行为。

概述

如果你的应用最低部署目标是 iOS 16、iPadOS 16、macOS 13、tvOS 16、watchOS 9、visionOS 1 或更高版本，请停止使用 NavigationView，改用 NavigationStack 和 NavigationSplitView 实例。具体怎么用，取决于你是在单栏中导航还是跨多栏导航。使用这些更新的容器，你可以更好地控制视图呈现、容器配置和编程式导航。

6.4 已弃用的符号

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/navigationlink-deprecated

6.4 已弃用的符号

查阅已弃用的导航链接构造器。

概述

关于如何更新你对导航符号的使用，参见迁移到新的导航类型。

用内容构建器创建链接

init(_:isActive:destination:) —— 创建一个导航链接，在处于激活状态时呈现目标视图，其文本标签由链接根据本地化字符串键生成。
init(isActive:destination:label:) —— 创建一个导航链接，在处于激活状态时呈现目标视图。
init(_:tag:selection:destination:) —— 创建一个导航链接，当绑定的选择变量与你提供的值相匹配时呈现目标视图，其文本标签由链接根据标题字符串生成。
init(tag:selection:destination:label:) —— 创建一个导航链接，当绑定的选择变量等于给定的标签值时呈现目标视图。

为 WatchKit 创建链接

init(destinationName:isActive:label:) —— 创建一个导航链接，在处于激活状态时呈现 WatchKit 故事板中的某个视图。
init(destinationName:tag:selection:label:) —— 创建一个导航链接，当绑定的选择变量与你提供的值相匹配时呈现 WatchKit 故事板中的某个视图。
init(destinationName:label:) —— 创建一个导航链接，呈现 WatchKit 故事板中的某个视图。

用视图实参创建链接

init(_:destination:isActive:) —— 创建一个导航链接，在处于激活状态时呈现目标视图，其文本标签由链接根据本地化字符串键生成。
init(destination:isActive:label:) —— 创建一个导航链接，在处于激活状态时呈现目标视图。
init(_:destination:tag:selection:) —— 创建一个导航链接，当绑定的选择变量与你提供的值相匹配时呈现目标视图，其文本标签由链接根据标题字符串生成。
init(destination:tag:selection:label:) —— 创建一个导航链接，当绑定的选择变量等于给定的标签值时呈现目标视图。

6.5 用标签页导航增强应用内容

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/enhancing-your-app-content-with-tab-navigation

6.5 用标签页导航增强应用内容

用标签栏提供快捷导航的同时，让应用内容始终处于醒目位置。

概述

Destination Video 采用了 sidebarAdaptable 标签页视图样式，它为每个平台优化了内容浏览体验。