← Granite (SwiftUI)

GraniteNavigation

Swift
public final class GraniteNavigation: ObservableObject {
    
    public struct Router {
        ...
    }

    public var asRouter: Router
    
    let isMain: Bool

    private var children: [String : GraniteNavigation] = [:]

    public init(isMain: Bool) 
    
    //Main data source
    internal var isActive = [String : Bool]()
    private var paths: [String: () -> AnyView] = [:]
    private var stack: [String] = []
    
    var level: Int
    
    //Internal hierarchy management
    func addChild(_ key: String, navigation: GraniteNavigation)
    
    @discardableResult
    func removeChild(_ key: String) -> GraniteNavigation?
    
    func child(_ key: String) -> GraniteNavigation?
    
    //Main Control logics
    func addressHeap<T: AnyObject>(o: T) -> Int

    @discardableResult
    func set<Component : GraniteComponent>(destinationStyle: GraniteNavigationDestinationStyle = .init(),
                                           @ViewBuilder _ component: @escaping (() -> Component)) -> String 
    
    func push(_ addr: String,
              window: GraniteRouteWindowProperties? = nil)
    
    func pop()
    
    func releaseStack()
}

Il s’agit essentiellement du centre de commande des instances de GraniteNavigation, créées pour chaque GraniteNavigationView.

Quand une instance est créée, elle s’attribue automatiquement un « id » selon le nombre disponible et selon qu’un routeur principal a été défini ou non.

Sous macOS, chaque fenêtre devrait avoir son propre main, les routeurs enfants y étant imbriqués.

Quand un GraniteComponent ou une View est poussé, il est enveloppé dans un NavigationComponent, lui-même enveloppé dans un Navigation Screen.

Je me demande encore si 2 couches d’imbrication sont nécessaires. Aller directement dans un Screen serait moins coûteux. Mais avoir accès aux EnvironmentValues dans une couche entre la présentation et la construction pourrait être utile pour d’autres besoins de personnalisation.

La vue cible n’est jamais « construite » avant que l’écran ne soit présenté. Elle est transmise sous forme de builders/handlers, c’est-à-dire () -> Content. C’est finalement l’écran qui gère la création. Comme l’écran est de type class, nous utilisons l’adresse mémoire de son tas (heap) comme clé pour le stocker dans la pile. Le tableau de ces adresses sert d’ordre de la pile, tandis que la table, paths, sert à la récupération. GraniteRouter montre comment ils sont affichés à la dernière étape du flux de navigation.

GraniteNavigation.Router | GraniteRouter

Ce sont 2 structs différentes. Mais GraniteNavigation.Router aide essentiellement à attribuer le prochain chemin que GraniteRouter doit afficher côté interface, en reliant la View cible à la bonne instance de GraniteNavigation.