← Granite (SwiftUI)

GraniteNavigation.Router

Swift
public final class GraniteNavigation: ObservableObject {
    
    public struct Router {
        public let id: String
        public init(id: String) {
            self.id = id
        }
        
        public var navigation: GraniteNavigation {
            GraniteNavigation.instance(for: id)
        }
        
        public func push<C: View>(style: GraniteNavigationDestinationStyle = .init(),
                                  window: GraniteRouteWindowProperties? = nil,
                                  @ViewBuilder _ content: @escaping () -> C) {
            self.navigation.push(destinationStyle: style,
                                 window: window,
                                 content)
        }
        
        public func push<C: GraniteNavigationDestination>(window: GraniteRouteWindowProperties? = nil,
                                                          @ViewBuilder _ content: @escaping () -> C) {
            self.navigation.push(window: window,
                                 content)
        }
        
        public func pop() {
            self.navigation.pop()
        }
    }

  ...

}

Dies ist im Wesentlichen der Haupt-Router, der den Views Ihrer Anwendung als EnvironmentValues bereitgestellt wird. So können Sie überall dort, wo er verfügbar ist, frei programmatisch Views pushen und poppen.

Swift
struct PostCardView: View {
    @Environment(\.graniteRouter) var router

    ...

    var body: some View {
        Button {
           router.push {
               PostDisplayView(context: _context,
                               updatedModel: currentModel)
           }
        } label: {
            Text("Push")
        }

        SomeView()
            .route {
                PostDisplayView(context: _context,
                                updatedModel: currentModel)
            } with: { router }
    }
}

So einfach ist das. Mehrere View-Extensions erleichtern den Zugriff auf die Routing-Funktionen, oder Sie rufen push bzw. pop einfach direkt auf. Die erfasste View oder GraniteComponent schiebt sich dann über den Aufrufer.

Swift
self.navigation.push(window: window, content)

Der Router-Struct findet die zugehörige GraniteNavigation-Instanz, um deren Push-/Pop-Funktionen zu nutzen.

Swift
public extension GraniteNavigation {
    func push<Component: View>(destinationStyle style: GraniteNavigationDestinationStyle = .init(),
                               window: GraniteRouteWindowProperties? = nil,
                               @ViewBuilder _ component: @escaping (() -> Component)) {
        
        let component = NavigationComponent<Component>(component)
        
        let memadd = self.set(destinationStyle: style) {
            component
        }
        
        self.push(memadd, window: window)
    }
}

Die Extension selbst verpackt die Komponente in eine NavigationComponent, setzt die Komponente und gibt eine Heap-Adresse zurück, mit der der Push angesteuert wird, sobald es so weit ist.

Swift
public func routeButton<C: GraniteNavigationDestination>(title: String = "",
                                                         window: GraniteRouteWindowProperties? = nil,
                                                         @ViewBuilder component : @escaping (() -> C),
                                                             with router: @escaping (() -> GraniteNavigation.Router)) -> some View {
        
    let router = router()
    let memadd = router.navigation.set {
        NavigationComponent<C>(component)
    }
    
    return Button {
        #if os(iOS)
        UIImpactFeedbackGenerator(style: .light).impactOccurred()
        #endif
        router.navigation.push(memadd, window: window)
    } label: {
        self
    }
}

set ist von push getrennt, für Fälle, in denen vor dem Push eine Bedingung eintreten soll, wir die Komponente aber für eine optimale Darstellungszeit schon setzen möchten.

Die View-Extensions wie oben ermöglichen lediglich eine sauberere Schreibweise innerhalb eines var body: some View-Builders in einer gewöhnlichen View. Theoretisch können Sie den Router für eine ganze App direkt verwenden.

Ein tatsächlicher Ausschnitt der set-Funktion in GraniteNavigation, die oben aufgerufen wird.

Swift
func set<Component : GraniteComponent>(destinationStyle: GraniteNavigationDestinationStyle = .init(),
                                           @ViewBuilder _ component: @escaping (() -> Component)) -> String {
        
    let screen = NavigationPassthroughComponent<Component, EmptyGranitePayload>.Screen<Component, EmptyGranitePayload>.init(component)
    let addr = NSString(format: "%p", addressHeap(o: screen)) as String
    
    paths[addr] = { AnyView(NavigationPassthroughComponent<Component,
                            EmptyGranitePayload>(screen: screen)
        .environment(\.graniteNavigationDestinationStyle, destinationStyle)) }
    
    isActive[addr] = false
    return addr
}

Der Screen ist wichtig, um GraniteNavigationDestinationStyle zu setzen. Damit können darstellende Views auf Ihrer Seite die Elemente der nachfolgenden Navigationsleiste und weitere Eigenschaften anpassen. Er hilft außerdem, den Lebenszyklus der Darstellung zu verwalten und die „Segues“ zu animieren.