SwiftUI 02-構建列表和導航(Building Lists and Navigation)

本章Demo 鏈接
Blog 鏈接

簡介

此示例是記錄學習SwiftUI的過程,原文出自
SwiftUI Essentials Building Lists and Navigation

SwiftUI 01-創建和組合視圖 (Creating and Combining Views) 中創建了landmark的詳情頁,本節我們做landmark的列表頁。

我們將創建可以顯示任何landmark信息的視圖,并動態生成一個滾動列表,用戶可以點擊該列表查看landmark的詳細視圖。要微調UI,我們將使用Xcode的畫布以不同的設備大小呈現多個預覽。

下載項目文件以開始構建此項目,并按照以下步驟操作。

第一節 了解示例中的數據

在第一個教程中, 我們直接把數據寫死在視圖的代碼中。現在我們將學習把數據傳遞給自定義視圖以供其顯示。
首先下載入門項目并熟悉示例數據。

2f8f9d15-348e-4c7f-b53d-be31a5d8c457.png
  • 1.在Project導航器中,選擇Models> Landmark.swift
    Landmark.swift聲明了一個Landmark的結構體,用于存儲應用程序需要顯示的所有landmark信息,根據landmarkData.json中其中一組數據的所有字段構建的landmark的model。

  • 2.在Project導航器中,選擇Resources> landmarkData.json

我們將在本教程的其余部分以及隨后的所有內容中使用此示例數據。

我們將在此以及以下每個教程中創建多個view的類。

第2節 創建行視圖

我們將在本教程中構建的第一個視圖是用于顯示每個地標的詳細信息的行。 此行視圖將信息存儲在其顯示的地標的屬性中,以便一個視圖可以顯示任何地標。 稍后,您將多個行組合成一個地標列表。

6f1c3da5-34c7-4c27-ba77-270ed2a29272.png
  • 1.創建一個名為LandmarkRow.swift的新SwiftUI視圖。

  • 2.如果預覽不可見,請通過選擇Editor > Editor and Canvas來顯示畫布,然后單擊Get Started

  • 3.添加LandmarkRow類中添加一個Landmark類型的landmark屬性作為這個視圖的模型。

import SwiftUI

struct LandmarkRow : View {
    var landmark: Landmark
    
    
    var body: some View {
        Text(/*@START_MENU_TOKEN@*/"Hello World!"/*@END_MENU_TOKEN@*/)
    }
}

#if DEBUG
struct LandmarkRow_Previews : PreviewProvider {
    static var previews: some View {
        LandmarkRow()
    }
}
#endif

添加landmark屬性時,預覽將停止工作,因為LandmarkRow類型在初始化期間需要傳入一個Landmark的模型。

Snip20190609_41.png

要修復預覽,我們需要修改預覽中初始化LandmarkRow()的代碼。

  • 4.在LandmarkRow_Previews的預覽靜態屬性中,將landmark參數添加到LandmarkRow()初始化方法的參數中,指定landmarkData數組的第一個元素。

預覽顯示文本Hello World。

修復后,您可以為行構建布局。

  • 5.將現有文本視圖嵌入HStack中。

  • 6.修改文本視圖以使用landmark屬性的name

  • 7.通過在文本視圖之前添加圖像來完成行。

Snip20190609_42.png

第3節 自定義行預覽

Xcode的畫布自動識別并顯示當前編輯器中符合PreviewProvider協議的任何類型。 預覽提供程序返回一個或多個視圖,其中包含用于配置大小和設備的選項。

我們可以從預覽提供程序自定義返回的內容,以準確呈現對我們最有幫助的預覽。

de4301fa-bf9c-45ac-b7f2-bbb990ccb41b.png
  • 1.在LandmarkRow_Previews中,將landmark參數更新為landmarkData數組中的第二個元素。

修改后預覽立即更改以顯示第二個model的數據而不是第一個。

  • 2.使用previewLayout(_ :)方法設置列表中這一行的cell大小。

我們可以在previews中使用group返回多行cell預覽。

  • 3.將返回的行換放到一個Group中,然后在Group中再添加一個LandmarkRow
Snip20190609_43.png
Snip20190609_44.png

Group是用于對視圖內容進行分組的容器。 Xcode將組的子視圖渲染為畫布中的單獨預覽。

  • 4.要簡化代碼,請將previewLayout(_ :)調用移動到Group的子聲明外部。
import SwiftUI

struct LandmarkRow : View {
    var landmark: Landmark
    
    
    var body: some View {
        HStack {
            landmark.image(forSize: 50)
            Text(landmark.name)
        }
    }
}

#if DEBUG
struct LandmarkRow_Previews : PreviewProvider {
    static var previews: some View {
        Group {
            LandmarkRow(landmark: landmarkData[0])
            LandmarkRow(landmark: landmarkData[1])
        }
        .previewLayout(.fixed(width: 300, height: 70))
    }
}
#endif

視圖的子項繼承視圖的上下文設置,例如預覽配置。

我們在預覽提供程序中編寫的代碼僅更改Xcode在畫布中顯示的內容。 由于#if DEBUG指令,編譯器會刪除代碼,因此它在release下不會打包到應用程序中。

第4節 創建landmark列表

使用SwiftUIList類型時,可以顯示特定于平臺的視圖列表。 列表的元素可以是靜態的,就像我們目前創建的堆棧的子視圖一樣,或者是動態生成的。 您甚至可以混合靜態和動態生成的視圖。

c91b6546-1230-43a2-8867-2f0e445edb99.png
  • 1.創建一個名為LandmarkList.swift的新SwiftUI視圖。

  • 2.用List替換模板中默認的Text視圖,并在List中添加兩個LandmarkRow初始化的視圖作為兩行顯示。

現在我們預覽顯示以適合iOS的列表樣式呈現的兩個landmark,這個List不就是UITableView嗎?

Snip20190609_45.png

第5節 使列表動態化

我們可以直接從集合中生成行,而不是單獨指定列表的元素。

我們可以通過傳遞數據集合以及為集合中的每個元素提供視圖的閉包來創建顯示集合元素的列表。 該列表使用提供的閉包將集合中的每個元素轉換為子視圖。

3f2f8071-97e1-481e-92a2-efb18be01ec7-1.png
  • 1.刪除List中兩個靜態的LandmarkRow,然后將landmarkData傳遞給List的初始化方法中。

列表使用可識別的數據。 我們可以通過以下兩種方式之一來識別數據:通過調用identified(by:)方法,使用唯一標識每個元素的屬性的鍵路徑,或者使您的數據類型遵守Identifiable協議。

  • 2.通過從閉包返回LandmarkRow來完成動態生成的列表。

這為landmarkData數組中的每個元素創建一個LandmarkRow

接下來,我們將通過向Landmark類型添加Identifiable協議來簡化List代碼。

  • 3.切換到Landmark.swift并聲明符合可識別協議。

由于Landmark類型已經具有Identifiable協議所需的id屬性,因此沒有其他工作要做。

  • 4.切換回LandmarkList.swift并刪除landmarkData調用的identified(by:)方法。
import SwiftUI

struct LandmarkList : View {
    var body: some View {
        List(landmarkData) { landmark in
            LandmarkRow(landmark: landmark)
        }
    }
}

#if DEBUG
struct LandmarkList_Previews : PreviewProvider {
    static var previews: some View {
        LandmarkList()
    }
}
#endif

從現在開始,我們將能夠直接使用Landmark元素的集合。

第6節 在列表和詳細信息之間設置導航

列表正確呈現,但我們無法點擊某個landmark以查看它的詳細信息頁面。

通過將導航功能嵌入到NavigationView中,然后將每行嵌套在NavigationButton中以設置到目標視圖的轉換,可以將導航功能添加到列表中。

c6f21df9-1d6d-42d4-b21b-0a2588f4cd97.png
  • 1.在NavigationView中嵌入動態生成的landmark列表。

  • 2.調用navigationBarTitle(_ :)修飾符方法以在顯示列表時設置導航欄的標題。

Snip20190609_48.png
  • 3.在列表的閉包內,將返回的行包裝在NavigationButton中,將LandmarkDetail視圖指定為目標。

  • 4.我們可以通過切換到實時模式直接在預覽中嘗試導航。 單擊“實時預覽”按鈕,然后點擊地標以訪問詳細信息頁面。

Snip20190609_49.png

第7節 將數據傳遞到子視圖

LandmarkDetail視圖中是使用寫死的數據展示UI 的。 就像LandmarkRow一樣,我們需要在LandmarkDetail中添加一個Landmark類型的模型以作為其數據源顯示view。

從子視圖開始,我們將轉換CircleImageMapViewLandmarkDetail以顯示傳入的數據,而不是將數據寫死在代碼中。

cb49732f-cb3e-4e77-a2e6-84f7f7618502.png
  • 1.在CircleImage.swift中,將存儲的圖像屬性添加到CircleImage
import SwiftUI

struct CircleImage : View {
    
    var image: Image
    
    var body: some View {
        image
            // 給圖片添加圓角
            .clipShape(Circle())
            // 給圓角添加邊框
            .overlay(Circle().stroke(Color.gray, lineWidth: 4))
            // 添加半徑為10的陰影
            .shadow(radius: 10)
    }
}

#if DEBUG
struct CircleImage_Previews : PreviewProvider {
    static var previews: some View {
        CircleImage(image: Image("turtlerock"))
    }
}
#endif

這是使用SwiftUI構建視圖時的常見模式。 自定義視圖通常會包裝并封裝特定視圖的一系列修飾符。

  • 2.更新CircleImage_Previews,給其傳遞一個Turtle Rock的圖像使其可以正常預覽。
  • 3.在MapView.swift中,向MapView添加一個坐標屬性,并轉換代碼以使用該屬性,而不是在代碼中寫死緯度和經度數據。

import SwiftUI
import MapKit

struct MapView: UIViewRepresentable {
    var coordinate: CLLocationCoordinate2D

    func makeUIView(context: Context) -> MKMapView {
        MKMapView(frame: .zero)
    }

    func updateUIView(_ view: MKMapView, context: Context) {

        let span = MKCoordinateSpan(latitudeDelta: 0.02, longitudeDelta: 0.02)
        let region = MKCoordinateRegion(center: coordinate, span: span)
        view.setRegion(region, animated: true)
    }
}

struct MapView_Preview: PreviewProvider {
    static var previews: some View {
        MapView()
    }
}
  • 4.更新預覽提供程序以傳遞數據數組中第一個landmark的坐標。

import SwiftUI
import MapKit

struct MapView: UIViewRepresentable {
    var coordinate: CLLocationCoordinate2D

    func makeUIView(context: Context) -> MKMapView {
        MKMapView(frame: .zero)
    }

    func updateUIView(_ view: MKMapView, context: Context) {
        let span = MKCoordinateSpan(latitudeDelta: 0.02, longitudeDelta: 0.02)
        let region = MKCoordinateRegion(center: coordinate, span: span)
        view.setRegion(region, animated: true)
    }
}

struct MapView_Preview: PreviewProvider {
    static var previews: some View {
        MapView(coordinate: landmarkData[0].locationCoordinate)
    }
}
  • 5.在LandmarkDetail.swift中,將Landmark類型的屬性添加到LandmarkDetail類型中,作為其model數據。

  • 6.更新預覽以使用landmarkData中的第一個lanmark

  • 7.完成將所需數據傳遞給您的自定義類型。

  • 8.最后,調用navigationBarTitle(_:displayMode :)方法,在顯示詳細視圖時為導航欄指定標題。

  • 9.在SceneDelegate.swift中,將rootViewControllerrootView修改為為LandmarkList,這樣首頁展示的就是列表頁了。

當我們在模擬器中獨立運行而不是預覽時,我們的應用程序將以SceneDelegate中定義的根視圖開始。

  • 10.在LandmarkList.swift中,將當前landmark傳遞到目標LandmarkDetail中,關鍵代碼為NavigationButton(destination: LandmarkDetail(landmark: landmark))
import SwiftUI

struct LandmarkList : View {
    var body: some View {
        // 設置導航容器
        NavigationView {
            // 初始化一個類型TableView的view
            List(landmarkData) { landmark in
                // 點擊cell時,將當前`landmark`傳遞到目標`LandmarkDetail`中。
                NavigationButton(destination: LandmarkDetail(landmark: landmark)) {
                    
                    LandmarkRow(landmark: landmark)
                }
            }
            // 顯示當前列表頁的導航標題
            .navigationBarTitle(Text("Landmarks"))
        }
        
    }
}

#if DEBUG
struct LandmarkList_Previews : PreviewProvider {
    static var previews: some View {
        LandmarkList()
    }
}
#endif

  • 11.切換到實時預覽以查看從列表導航時詳細視圖顯示正確的標志

第8節 動態生成預覽

接下來,我們將向LandmarkList_Previews預覽提供程序添加代碼,以顯示不同設備大小的列表視圖的預覽。 默認情況下,預覽會以活動方案中設備的大小進行渲染。 我們可以通過調用previewDevice(_ :)方法來更改預覽設備。

475e4ac3-b605-4309-a294-e9d2efa6f1ab.png
  • 1.首先,將當前列表預覽更改為以iPhone SE的大小呈現。
#if DEBUG
struct LandmarkList_Previews : PreviewProvider {
    static var previews: some View {
        LandmarkList()
            // 以iPhone SE 設備的大小預覽畫布
            .previewDevice(PreviewDevice(rawValue: "iPhone SE"))
        
    }
}
#endif

我們可以提供Xcode方案菜單中顯示的任何設備的名稱。

Snip20190609_50.png
  • 2.在畫布中添加對多個設備的預覽
    在預覽的列表中,使用設備名稱數組作為數據,將LandmarkList嵌入到ForEach實例中。
Snip20190609_51.png

ForEach以與列表相同的方式對集合進行操作,這意味著我們可以在任何可以使用子視圖的位置使用它,例如在堆棧,列表,組等中。 當數據元素是簡單的值類型 - 就像在這里使用的字符串一樣 - 我們可以使用\ .self作為標識符的關鍵路徑。

  • 3.使用previewDisplayName(_ :)修飾符將設備名稱添加為預覽的標簽。
Snip20190609_52.png
  • 4.我們可以嘗試使用不同的設備來比較視圖的渲染,所有這些都來自畫布。

測試

  • 1.除了List之外,這些類型中的哪一個提供了集合中的動態視圖列表?

可選項:
1.Group
2.ForEath
3.UITableView

答案:2

  • 2.我們可以從可識別元素集合中創建視圖列表。 我們使用什么方法來調整不符合可識別協議的元素集合?

可選項:
1.func map(_:)
2.func sorted(by:)
3.func identified(by:)

答案:3

  • 3.用哪種類型來使List的行可以導航到另一個視圖?

可選項:
1.NavigationButton
2.UITableViewDelegate
3.NavigationView

答案: 1

  • 4.哪些選項不是設置設備以預覽視圖的方法?

可選項:

  1. Change the simulator selected in the active scheme.
  2. Make a different choice in Canvas Settings in Xcode’s preferences.
  3. Specify one or more devices using the previewDevice(_:)method.
  4. Connect your development device and click the Device Preview button.

答案:2

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容