← 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()
}

असल में यह उन GraniteNavigation इंस्टेंस का कमांड सेंटर है जो हर GraniteNavigationView के लिए बनाए जाते हैं।

जब कोई इंस्टेंस बनता है, तो वह उपलब्ध गिनती और इस बात के आधार पर कि main राउटर सेट हुआ है या नहीं, अपने आप को ख़ुद ही “id” दे देता है।

macOS पर हर विंडो का अपना main होना चाहिए, और चाइल्ड राउटर उसके भीतर नेस्ट होते हैं।

जब किसी GraniteComponent या View को Push किया जाता है, तो उसे NavigationComponent में लपेटा जाता है, जो फिर एक Navigation Screen में लपेटा जाता है।

मैं अब भी सोच रहा हूँ कि क्या नेस्टिंग की 2 परतें ज़रूरी हैं। सीधे Screen में जाना कम भारी होता। लेकिन प्रस्तुति और निर्माण के बीच की एक परत में EnvironmentValues तक पहुँच होना आगे की कस्टमाइज़ेशन ज़रूरतों के लिए मददगार हो सकता है।

लक्ष्य view तब तक कभी “बनाया” नहीं जाता जब तक screen प्रस्तुत न हो। उसे Builders/handlers के रूप में पास किया जाता है, यानी () -> Content। आख़िर में screen ही उसका निर्माण सँभालती है। चूँकि screen class टाइप की है, इसलिए स्टैक में रखते समय हम उसकी heap के मेमोरी एड्रेस को कुंजी की तरह इस्तेमाल करते हैं। इन एड्रेस की array स्टैक का क्रम तय करती है, जबकि map, यानी paths, उन्हें वापस पाने के काम आता है। GraniteRouter दिखाता है कि नेविगेशन प्रवाह के आख़िरी चरण में ये कैसे प्रदर्शित होते हैं।

GraniteNavigation.Router | GraniteRouter

ये 2 अलग structs हैं। लेकिन GraniteNavigation.Router असल में लक्ष्य View को सही GraniteNavigation इंस्टेंस से जोड़कर, GraniteRouter को फ्रंट-एंड पर दिखाने के लिए अगला path तय करने में मदद करता है।