NavigationView Logo

导航变得简单

立即改善您项目中的导航。保持代码简洁

Mijick 的 NavigationView 是一个强大的开源库，专为 SwiftUI 设计，使导航过程变得非常简单和清晰。

自定义动画。 我们的库提供对任何动画的完全支持。
手势支持。 您可以轻松地为选定的屏幕启用导航手势。
记住当前的滚动视图偏移量。 当您离开视图时，库会自动保存当前的滚动视图偏移量。
提高代码质量。 只需一行代码即可在屏幕之间导航。专注于对您和您的项目重要的事情，而不是 Swift 的复杂性。
最终的稳定性！ 在 Mijick，我们意识到原生 NavigationView 存在的问题（并且仍然存在），以及它给开发人员带来了多少问题。因此，在开发过程中，我们最重视库的可靠性和性能。
专为 SwiftUI 设计。 在开发该库时，我们利用了 SwiftUI 的强大功能，为您提供强大的工具来加速您的实现过程。

开始使用

✋ 要求

平台	最低 Swift 版本
iOS 15+	5.0

⏳ 安装

Swift Package Manager

Swift Package Manager 是一种用于自动化 Swift 代码分发的工具，并已集成到 Swift 编译器中。

一旦您设置了 Swift 包，将 NavigationView 添加为依赖项就像将其添加到您的 Package.swift 的 dependencies 值一样简单。

dependencies: [
    .package(url: "https://github.com/Mijick/NavigationView", branch(“main”))
]

Cocoapods

Cocoapods 是 Swift 和 Objective-C Cocoa 项目的依赖项管理器，可帮助优雅地扩展它们。

安装步骤

安装 CocoaPods 1.10.0（或更高版本）
为您的项目生成 CocoaPods

pod init

将 CocoaPods 依赖项添加到您的 Podfile 中

pod 'MijickNavigationView'

安装依赖项并生成 .xcworkspace 文件

pod install

使用新的 XCode 项目文件 .xcworkspace

用法

1. 设置库

在您的 @main 结构内部，使用作为导航堆栈根视图的视图调用 implementNavigationView 方法。该视图必须是 NavigatableView 类型。该方法采用一个可选参数 - config，可用于配置将放置在导航堆栈中的所有视图的某些属性。

@main struct NavigationView_Main: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
               .implementNavigationView(config: nil)                    
        }
    }
}

2. 声明要推送到导航堆栈的视图

Mijick 的 NavigationView 提供了将任何符合 NavigatableView 协议的视图推送到导航堆栈的能力。

struct ExampleView: NavigatableView {
    ...
}

3. 实现 `body`

用内容填充您的视图

struct ExampleView: NavigatableView {    
    var body: some View {
        VStack(spacing: 0) {
            Text("Witaj okrutny świecie")
            Spacer()
            Button(action: pop) { Text("Pop") } 
        }
    }
    ...
}

4. 实现 `configure(view: NavigationConfig) -> NavigationConfig` 方法

此步骤是可选的 - 如果您愿意，您可以跳过此步骤并保持配置为默认值。
每个视图都有自己的一组方法，可用于为堆栈中的每个视图创建独特的外观。

struct ExampleView: NavigatableView {   
    func configure(view: NavigationConfig) -> NavigationConfig { view.backgroundColour(.red) }
    var body: some View {
        VStack(spacing: 0) {
            Text("Witaj okrutny świecie")
            Spacer()
            Button(action: pop) { Text("Pop") } 
        }
    }
    ...
}

5. 显示您的视图 - 从代码中的任何位置！

只需从选定的位置调用 ExampleView().push(with:)。就这么简单！

struct SettingsViewModel {
    ...
    func openSettings() {
        ...
        ExampleView().push(with: .verticalSlide)
        ...
    }
    ...
}

6. 关闭您的视图 - 它甚至更简单！

有两种方法可以做到这一点

通过在任何视图中调用方法 pop、pop(to type:)、popToRoot 之一

struct ExampleView: NavigatableView {
    ...
    func createButton() -> some View {
        Button(action: popToRoot) { Text("Tap to return to root") } 
    }
    ...
}

通过调用静态 NavigationManager 方法之一
- NavigationManager.pop()
- NavigationManager.pop(to type:)，其中 type 是您要返回的视图的类型
- NavigationManager.popToRoot()

7. 等等，还有更多！

我们快完成了，但我们想描述您可能喜欢的另外三种方法

使用 setAsNewRoot 方法，您可以更改导航堆栈的根

ExampleView()
    .push(with: .verticalSlide)
    .setAsNewRoot()

可以传递 EnvironmentObject，但请记住在将视图推送到堆栈之前执行此操作

ExampleView()
    .environmentObject(object)
    .push(with: .verticalSlide)

使用 onFocus，而不是 onAppear
如果您希望在每次视图可见（位于堆栈顶部）时收到通知，请使用 onFocus 方法

struct ExampleView: NavigatableView {    
    var body: some View {
        VStack(spacing: 0) {
            Text("Witaj okrutny świecie")
            Spacer()
            Button(action: pop) { Text("Pop") } 
        }
        .onFocus(self) {
            // Do something
        }
    }
    ...
}

尝试我们的演示

通过克隆我们创建的项目，亲身体验一下它是如何工作的

许可证

NavigationView 在 MIT 许可证下发布。有关详细信息，请参阅 LICENSE。

我们其他的开源 SwiftUI 库

PopupView - 最强大的弹出库，允许您显示任何弹出窗口
CalendarView - 立即创建您自己的日历对象
GridView - 毫不费力地布局您的数据
CameraView - 最强大的 CameraController。专为 SwiftUI 设计
Timer - Timer 的现代 API