在SwiftUI中创建程序化导航的教程

242 阅读5分钟

默认情况下,SwiftUI 提供的各种导航 API 在很大程度上是以用户直接输入为中心的--也就是说,导航是由系统根据点击按钮和切换标签等事件来处理的。

然而,有时我们可能想更直接地控制应用程序的导航执行方式,尽管SwiftUI在这方面仍然不如UIKit或AppKit灵活,但它确实提供了相当多的方法,让我们在构建的视图中执行完全可编程的导航。

切换标签

让我们先看看我们如何控制当前在TabView 中显示的标签。通常情况下,只要用户手动点击每个标签栏中的一个项目,标签就会被切换,但通过将selection 绑定到一个给定的TabView ,我们可以观察并控制当前显示的标签。在这里,我们就是这样做的,在两个标签之间进行切换,这两个标签是用整数01 来标记的:

struct RootView: View {
    @State private var activeTabIndex = 0

    var body: some View {
        TabView(selection: $activeTabIndex) {
            Button("Switch to tab B") {
                activeTabIndex = 1
            }
            .tag(0)
            .tabItem { Label("Tab A", systemImage: "a.circle") }

            Button("Switch to tab A") {
                activeTabIndex = 0
            }
            .tag(1)
            .tabItem { Label("Tab B", systemImage: "b.circle") }
        }
    }
}

但真正伟大的是,在识别和切换标签时,我们并不仅仅局限于使用整数。相反,我们可以自由地使用任何Hashable 值来表示每个标签--例如通过使用一个枚举,包含我们想要显示的每个标签的情况。然后我们可以将这部分状态封装在一个ObservableObject ,我们将能够很容易地注入到我们的视图层次环境中:

enum Tab {
    case home
    case search
    case settings
}

class TabController: ObservableObject {
    @Published var activeTab = Tab.home

    func open(_ tab: Tab) {
        activeTab = tab
    }
}

有了上述内容,我们现在可以使用新的Tab 类型来标记TabView 中的每个视图,如果我们将TabController 注入到我们的视图层次环境中,那么其中的任何视图都可以在任何时候切换显示的标签。

struct RootView: View {
    @StateObject private var tabController = TabController()

    var body: some View {
        TabView(selection: $tabController.activeTab) {
            HomeView()
                .tag(Tab.home)
                .tabItem { Label("Home", systemImage: "house") }

            SearchView()
                .tag(Tab.search)
                .tabItem { Label("Search", systemImage: "magnifyingglass") }

            SettingsView()
                .tag(Tab.settings)
                .tabItem { Label("Settings", systemImage: "gearshape") }
        }
        .environmentObject(tabController)
    }
}

例如,这里是我们的HomeView ,现在可以使用一个完全自定义的按钮切换到设置标签--它只需要从环境中获得我们的TabController ,然后它可以调用open 方法来执行标签切换--像这样:

struct HomeView: View {
    @EnvironmentObject private var tabController: TabController

    var body: some View {
        ScrollView {
            ...
            Button("Open settings") {
                tabController.open(.settings)
            }
        }
    }
}

很好!另外,由于TabController 是一个在我们完全控制之下的对象,我们也可以用它来从我们的主视图层次结构之外切换标签。例如,我们可能想根据推送通知或其他类型的服务器事件来切换标签,现在可以通过调用我们在上述视图代码中使用的相同的open 方法来完成。

控制导航堆栈

就像标签视图一样,SwiftUI的NavigationView ,也可以通过程序控制。例如,假设我们正在开发一个应用程序,在其主导航堆栈中显示一个CalendarView 作为根视图,然后用户可以通过点击位于应用程序导航栏中的编辑按钮来打开一个CalendarEditView 。为了连接这两个视图,我们使用了一个NavigationLink ,只要点击它,它就会自动将一个给定的视图推送到导航堆栈中:

struct RootView: View {
    @ObservedObject var calendarController: CalendarController

    var body: some View {
        NavigationView {
            CalendarView(
                calendar: calendarController.calendar
            )
            .toolbar {
                ToolbarItem(placement: .navigationBarTrailing) {
                    NavigationLink("Edit") {
                        CalendarEditView(
                            calendar: $calendarController.calendar
                        )
                        .navigationTitle("Edit your calendar")
                    }
                }
            }
            .navigationTitle("Your calendar")
        }
        .navigationViewStyle(.stack)
    }
}

在这种情况下,我们在所有设备上使用stack ,甚至是iPad,而不是让系统来选择使用哪种导航风格。

现在我们假设,我们想让我们的CalendarView ,以编程方式显示其编辑视图,而不需要构建一个单独的实例。要做到这一点,我们可以在我们的编辑按钮的NavigationLink 中注入一个isActive 绑定,然后我们把它也传递给我们的CalendarView - 像这样:

struct RootView: View {
    @ObservedObject var calendarController: CalendarController
    @State private var isEditViewShown = false

    var body: some View {
        NavigationView {
            CalendarView(
                calendar: calendarController.calendar,
                isEditViewShown: $isEditViewShown
            )
            .toolbar {
                ToolbarItem(placement: .navigationBarTrailing) {
                    NavigationLink("Edit", isActive: $isEditViewShown) {
                        CalendarEditView(
                            calendar: $calendarController.calendar
                        )
                        .navigationTitle("Edit your calendar")
                    }
                }
            }
            .navigationTitle("Your calendar")
        }
        .navigationViewStyle(.stack)
    }
}

如果我们现在也更新CalendarView ,使其接受上述使用@Binding-marked属性的值,那么我们现在可以在任何时候简单地将该属性设置为true ,以显示我们的编辑视图,而我们的根视图的NavigationLink 将自动被触发:

struct CalendarView: View {
    var calendar: Calendar
    @Binding var isEditViewShown: Bool

    var body: some View {
        ScrollView {
            ...
            Button("Edit calendar settings") {
                isEditViewShown = true
            }
        }
    }
}

当然,我们也可以选择将我们的isEditViewShown 属性封装在某种形式的ObservableObject 中,比如一个NavigationController ,就像我们之前在处理TabView 时做的那样。

这就是我们如何以编程方式触发显示在我们的用户界面中的NavigationLink ,但是如果我们想在不给用户任何直接控制的情况下执行这种导航呢?

例如,让我们现在说,我们正在开发一个包括导出功能的视频编辑应用程序。当用户进入导出流程时,一个VideoExportView ,一旦导出操作完成,我们想把一个VideoExportFinishedView 推到该模态的导航栈上。

起初,这可能看起来非常棘手,因为(由于SwiftUI是一个声明式的UI框架)没有任何push ,我们可以在任何时候调用这个方法来向我们的导航栈添加一个新的视图。事实上,在一个NavigationView 内推送一个新视图的唯一内置方法是使用NavigationLink ,这需要成为我们视图层次结构本身的一部分。

也就是说,这些导航链接实际上不一定是可见的--所以在这种情况下,实现我们的目标的一个方法是在我们的视图中添加一个隐藏的NavigationLink ,然后我们可以在视频导出操作完成后以编程方式触发。如果我们也在我们的目标视图中隐藏系统提供的返回按钮,那么我们就可以完全锁定用户,使其无法在这两个视图之间手动导航:

struct VideoExportView: View {
    @ObservedObject var exporter: VideoExporter
    @State private var didFinish = false
    @Environment(\.presentationMode) private var presentationMode

    var body: some View {
        NavigationView {
            VStack {
                ...
                Button("Export") {
                    exporter.export {
                        didFinish = true
                    }
                }
                .disabled(exporter.isExporting)

                NavigationLink("Hidden finish link", isActive: $didFinish) {
                    VideoExportFinishedView(doneAction: {
                        presentationMode.wrappedValue.dismiss()
                    })
                    .navigationTitle("Export completed")
                    .navigationBarBackButtonHidden(true)
                }
                .hidden()
            }
            .navigationTitle("Export this video")
        }
        .navigationViewStyle(.stack)
    }
}

struct VideoExportFinishedView: View {
    var doneAction: () -> Void

    var body: some View {
        VStack {
            Label("Your video was exported", systemImage: "checkmark.circle")
            ...
            Button("Done", action: doneAction)
        }
    }
}

我们将一个doneAction 闭包注入到我们的VideoExportFinishedView ,而不是让它自己检索当前的presentationMode ,原因是我们希望解散我们的整个模态流程,而不仅仅是那个特定视图。

使用这样一个隐藏的NavigationLink ,肯定会被认为是一个有点 "黑 "的解决方案,但它的效果很好,如果我们把导航链接看成是导航堆栈中两个视图之间的连接(而不仅仅是一个按钮),那么上述设置可以说是有意义的。

总结

尽管SwiftUI的导航系统仍然不如UIKit和AppKit提供的系统灵活,但它已经足够强大,可以满足很多不同的使用情况--特别是当与SwiftUI非常全面的状态管理系统相结合时。

当然,我们也总是可以选择将我们的SwiftUI视图层次包裹在托管控制器内,只使用UIKit/AppKit来实现我们的导航代码。哪种解决方案是最合适的,可能取决于我们在每个项目中实际想要执行多少自定义和程序化的导航。

谢谢你的阅读!