细品Swift - 强大的导航栈 NavigationStack

细品Swift - Navigation Stack

NavigationStack是苹果在2022年WWDC大会推出的一项重要ios16 swiftui特性。 它是NavigationView的替代,解决了其使用起来的一些问题,并且更大强大和灵活。

总览

NS通过让导航链接的值和具体的导航行为分离,使得导航行为更加容易控制。另外引入了导航路径的概念,让用户可以任意压入/弹出/替代导航路径,是的导航控制极为灵活。

简单替代NavigationView

首先,可以直接用NavigationStack替代NavigationView,程序效果没有任何变化。 如下面程序所示。

// MARK: - 用NavigationStack可以简单直接的替换NavigationView
//        NavigationView{
        NavigationStack {
            List {
                NavigationLink("Apple") {
                    Text("Here is an apple")
                }
                
                NavigationLink("Banana") {
                    Text("Here is a banana")
                }
                
                NavigationLink("Lemon") {
                    Text("Here is a lemon")
                }
            }
            .navigationTitle("Fruits")
        }
        
    }

导航值和导航目标分离/目标集中处理

NavigationView被人诟病的问题之一是它在控制链接目标时难于使用。在编程控制链接目标方面,NavigationStack的结构更加清晰明确。后者把链接目标控制从每个link语句中抽出来,放在语句中进行统一控制。

    .navigationDestination(for: <#T##Hashable.Protocol#>, destination: <#T##(Hashable) -> View#>)

请看下面的示例。每个链接目标语句都附有一个value值。可以这样理解,当一个链接被点击时,value值被记下,并转到navigationDestination处进行处理,在处理时传入当前的value值。 navigationDestination第一个参数for说明可以接受的value值的类型;第二个参数是个返回View的closure,传入被点击的value值,并返回基于这个value值计算出的新View,作为链接目标的下一个页面返回。

            NavigationStack {
                List {
                    // 每个link对应一个Hashable的值,这里用的是简单的String。enum值也经常被使用。
                    NavigationLink("Apple2", value: "Apple")
                    NavigationLink("Banana2", value: "Banana")
                    NavigationLink("Lemon2", value: "Lemon")
                }
                // 在这里统一处理链接目标。第一个参数for:说明可以接受的value值的类型;第二个参数是个返回View的closure。传入某个value值,并返回基于这个value值计算出的新View,作为链接目标返回。
                .navigationDestination(for: String.self) { fruit in
                    Text("Link to \(fruit)")
                }
   
            }

NavigationStack使链接目标的控制集中在一处,编程控制起来更清晰。这里是更复杂一点的示例,value是enum类型。

    enum Stationary: String {
        case notebook, pencil, ruler
    }


    // MARK: - NavigationStack使链接目标的控制集中在一处,编程控制起来更清晰。这里是更复杂一点的示例,value是enum类型。

    NavigationStack {
        List {
            // 每个link对应一个Hashable的值,这里用的是简单的String。enum值也经常被使用。
            NavigationLink("Notebook", value: Stationary.notebook)
            NavigationLink("Pencil", value: Stationary.pencil)
            NavigationLink("Ruler", value: Stationary.ruler)
        }
        // 在这里统一处理链接目标。第一个参数for:说明可以接受的value值的类型;第二个参数是个返回View的closure。传入某个value值,并返回基于这个value值计算出的新View,作为链接目标返回。
        .navigationDestination(for: Stationary.self) { stationary in
            Text("Link to \(stationary.rawValue)")
        }

    }

这里再介绍一种更复杂的情况: 在一个NavigationStack中存在两种或以上的值类型,则根据各自的值类型去寻找链接目标。

    // MARK: - 混合值类型。 NavigationStack使链接目标的控制集中在一处,编程控制起来更清晰。这里是更更复杂一点的示例,两种Value类型的混合: String和自定义enum类型。

    NavigationStack {
        List {
            // 两种值类型。点击时各自寻找处理自己值类型的navigationDestination
            NavigationLink("Notebook", value: Stationary.notebook)
            NavigationLink("Pencil", value: Stationary.pencil)
            NavigationLink("Ruler", value: Stationary.ruler)
            
            NavigationLink("Apple2", value: "Apple")
            NavigationLink("Banana2", value: "Banana")
            NavigationLink("Lemon2", value: "Lemon")
        }
        //需要提供对应多种值类型的导航目标
        .navigationDestination(for: Stationary.self) { stationary in
            Text("Link to \(stationary.rawValue)")
        }
        .navigationDestination(for: String.self) { fruit in
            Text("Link to \(fruit)")
            Image(systemName: "leaf.fill")
        }

    }

最后提示一下,以下方法是之前NavigationView中使用的,都已经被苹果标为过时,不建议使用。

    NavigationLink(destination: <#T##_#>, tag: <#T##Hashable#>, selection: <#T##Binding<Hashable?>#>, label: <#T##() -> _#>)
    NavigationLink(<#T##title: StringProtocol##StringProtocol#>, tag: <#T##Hashable#>, selection: <#T##Binding<Hashable?>#>, destination: <#T##() -> _#>)

导航路径(path)让导航控制更为灵活

从上一小节我们看到,navigationDestination让编程控制链接目标方便处理。但NavigationStack提供给我们的不仅如此, 它还提供了控制导航页面堆栈的path工具,从另一个维度让导航控制更加强大。path的使用方法有两种,区分是堆栈中的值是否为同一种类型。 如果是同一种类型,可以用一个数组来标识path。否则,需要用到NavigationPath类型。

  • 链接值为同一类型,可以用一个数组来表示路径(堆栈)。
  • 链接值非同一类型,必须用NavigationPath来表示路径(堆栈)。

首先的范例是同类型的路径堆栈。


    @State var sameValueTypePath: [Stationary] = []
    

    // MARK: - 同类型的路径堆栈
    // 首先,在NavigationStack上加入path参数。
    NavigationStack(path: $sameValueTypePath) {
        List {
            // 符合path数组中类型的链接。
            NavigationLink("Notebook For Path", value: Stationary.notebook)
            NavigationLink("Pencil For Path", value: Stationary.pencil)
            NavigationLink("Ruler For Path", value: Stationary.ruler)
            
            // 不符合path数组中类型的链接,点击无效
            NavigationLink("Something Weird", value: "Weird")
            
            // 向path中加入两个值,即向导航堆栈中压入两个页面。
            // 点击此按钮后进入pencil页面,点击back返回键,会发现pencil页面返回到ruler页面,然后才是根页面。
            
            Button("Add something to path") {
                sameValueTypePath.append(.ruler)
                sameValueTypePath.append(.pencil)
            }
        }
        .navigationDestination(for: Stationary.self) { stationary in
            
            VStack {
                Text("Link to \(stationary.rawValue)")
                Text(sameValueTypePath.map(\.rawValue).joined(separator: "/"))
            
            }
            .toolbar {
                ToolbarItem(placement: .navigationBarTrailing) {
                    
                    // 通过清空path,让导航堆栈清空,直接回到根导航页面。
                    Button("Return to root") {
                        sameValueTypePath = []
                    }
                }
            }
           
        }
    }

NavigationStack中可能是最强大的功能就是对混合路径堆栈的自由控制。请看以下范例:

            // MARK: - 不同类型值的混合路径堆栈
            // 首先,在NavigationStack上加入path参数。
            NavigationStack(path: $hybridValueTypePath) {
                List {
                    // 任意值类型的链接都可以加入path
                    NavigationLink("Notebook For Path", value: Stationary.notebook)
                    NavigationLink("Pencil For Path", value: Stationary.pencil)
                    NavigationLink("Ruler For Path", value: Stationary.ruler)
                    
                    //
                    NavigationLink("Apple2", value: "Apple")
                    NavigationLink("Banana2", value: "Banana")
                    NavigationLink("Lemon2", value: "Lemon")
                    
                    // 向path中加入类型不完全相同的三个值,即向导航堆栈中压入三个页面。
                    // 点击此按钮后进入pencil页面,点击back返回键,会发现页面依次返回:
                    // pencil -> Apple -> ruler -> 根页面
                    
                    Button("Add something to path") {
                        hybridValueTypePath.append(Stationary.ruler)
                        hybridValueTypePath.append("Apple")
                        hybridValueTypePath.append(Stationary.pencil)
                    }
                }
                // 自定义enum类型Stationary的链接目标
                .navigationDestination(for: Stationary.self) { stationary in
                    
                    VStack {
                        Text("Link to \(stationary.rawValue)")
                        Text(String(hybridValueTypePath.count))
                        
                    }
                    .toolbar {
                        ToolbarItem(placement: .navigationBarTrailing) {
                            
                            // 通过让导航堆栈清空,直接回到根导航页面。
                            Button("Return to root") {
                                hybridValueTypePath.removeLast(hybridValueTypePath.count)
                            }
                        }
                    }
                    
                }
                // String类型的链接目标
                .navigationDestination(for: String.self) { fruit in
                    Text("Link to \(fruit)")
                    Image(systemName: "leaf.fill")
                }
            }

总结起来,NavigationStack比前身NavigationView更为强大,提供了灵活的页面栈操作,而且可以处理混合导航值类型。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,384评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,845评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,148评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,640评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,731评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,712评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,703评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,473评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,915评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,227评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,384评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,063评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,706评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,302评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,531评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,321评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,248评论 2 352

推荐阅读更多精彩内容