[SwiftUI教程]二、建立和組合視圖

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公衆號：山青詠芝（shanqingyongzhi）
➤博客園地址：山青詠芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：http://www.javashuo.com/article/p-uqydnvyt-et.html
➤若是連接不是山青詠芝的博客園地址，則多是爬取做者的文章。
➤原文已修改更新！強烈建議點擊原文地址閱讀！支持做者！支持原創！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★css

本教程將指導您構建標記 - 一個用於發現和分享您喜好的地方的iOS應用程序。您將首先構建顯示地標詳細信息的視圖。html

爲了佈局視圖，地標使用堆棧來組合和分層圖像和文本視圖組件。要向視圖添加地圖，您將包含標準MapKit組件。在細化視圖的設計時，Xcode提供實時反饋，以便您能夠看到這些更改如何轉換爲代碼。git

下載項目文件以開始構建此項目，並按照如下步驟操做。github

預計的時間：40分

項目文件：https://docs-assets.developer.apple.com/published/4a0d357155/CreatingAndCombiningViews.zip

Xcode 11 beta ：https://developer.apple.com/download/

1、建立一個新項目並探索畫布

建立一個使用SwiftUI的新Xcode項目。瀏覽畫布，預覽和SwiftUI模板代碼。swift

要預覽Xcode中畫布中的視圖並與之交互，請確保您的Mac正在運行macOS 10.15 beta。微信

第1步app

打開Xcode，在Xcode的啓動窗口中單擊「建立新的Xcode項目」，或選擇 File > New > Project.編輯器

第2步ide

在模板選擇器中，選擇iOS做爲平臺，選擇Single View App模板，而後單擊Next。工具

第3步

輸入「Landmarks」做爲Product Name，選擇Use SwiftUI複選框，而後單擊Next。選擇一個位置以在Mac上保存標記項目。

第4步

在項目導航器中，單擊以選中。ContentView.swift

默認狀況下，SwiftUI視圖文件聲明瞭兩種結構。第一個結構符合View協議並描述視圖的內容和佈局。第二個結構聲明該視圖的預覽。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         Text("Hello World")
 6     }
 7 }
 8 
 9 struct ContentView_Preview: PreviewProvider {
10     static var previews: some View {
11         ContentView()
12     }
13 }

第5步

在畫布中，單擊「 Resume 」以顯示預覽。

注意：若是畫布不可見，請選擇Editor > Editor and Canvas以顯示它。

第6步

在body屬性內，將「Hello World」更改成您本身的問候語。

當您更改視圖body屬性中的代碼時，預覽會更新以反映您的更改。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         Text("Hello SwiftUI!")
 6     }
 7 }
 8 
 9 struct ContentView_Preview: PreviewProvider {
10     static var previews: some View {
11         ContentView()
12     }
13 }

2、自定義文本視圖

您能夠經過更改代碼或使用檢查器發現可用內容並幫助您編寫代碼來自定義視圖的顯示。

在構建標記應用程序時，您可使用任何編輯器組合：源編輯器，畫布或檢查器。不管您使用哪一種工具，代碼都會保持更新。

接下來，您將使用檢查器自定義文本視圖。

步驟1

在預覽中，按住Command鍵並單擊問候語以顯示結構化編輯彈出窗口，而後選擇「檢查」。

彈出窗口顯示您能夠自定義的不一樣屬性，具體取決於您檢查的視圖類型。

第1步

在預覽中，按住Command鍵並單擊問候語以顯示結構化編輯彈出窗口，而後選擇「檢查」。

彈出窗口顯示您能夠自定義的不一樣屬性，具體取決於您檢查的視圖類型。

第2步

使用檢查器將文本更改成「Turtle Rock」，即您將在應用中顯示的第一個地標的名稱。

第3步

將「字體」修改器更改成「標題」。

這將系統字體應用於文本，以便它正確響應用戶的首選字體大小和設置。

第4步

手動編輯代碼以添加color(.green)修飾符; 這會將文本的顏色更改成綠色。

要自定義SwiftUI視圖，請調用稱爲修飾符的方法。修改器包裝視圖以更改其顯示或其餘屬性。每一個修改器都返回一個新視圖，所以連接垂直堆疊的多個修改器是很常見的。

 1 ContentView.swift
 2 import SwiftUI
 3 
 4 struct ContentView: View {
 5     var body: some View {
 6         Text("Turtle Rock")
 7             .font(.title)
 8             .color(.green)
 9     }
10 }
11 
12 struct ContentView_Preview: PreviewProvider {
13     static var previews: some View {
14         ContentView()
15     }
16 }

您的代碼始終是視圖的真實來源。當您使用檢查器更改或刪除修改器時，Xcode會當即更新您的代碼以匹配。

第5步

此次，經過Text在代碼編輯器中單擊聲明來打開檢查器，而後從彈出窗口中選擇Inspect。單擊「顏色」彈出菜單，而後選擇「繼承」以再次將文本顏色更改成黑色。

第6步

請注意，Xcode會自動更新代碼以反映更改，刪除color(.green)修飾符。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         Text("Turtle Rock")
 6             .font(.title)
 7 
 8     }
 9 }
10 
11 struct ContentView_Preview: PreviewProvider {
12     static var previews: some View {
13         ContentView()
14     }
15 }

3、使用堆棧組合視圖

除了您在上一部分中建立的標題視圖以外，您還將添加文本視圖以包含有關地標的詳細信息，例如公園的名稱和狀態。

建立SwiftUI視圖時，您能夠在視圖的body屬性中描述其內容，佈局和行爲; 可是，該body屬性僅返回單個視圖。您能夠在堆棧中組合和嵌入多個視圖，這些視圖將視圖水平，垂直或從後到前組合在一塊兒。

在本節中，您將使用垂直堆棧將標題置於包含公園詳細信息的水平堆棧上方。

您可使用Xcode的結構化編輯支持將視圖嵌入容器視圖，打開檢查器或幫助進行其餘有用的更改。

第1步

按住Command鍵並單擊文本視圖的初始值設定項以顯示結構化編輯彈出窗口，而後選擇「嵌入VStack」。

接下來，您將經過Text從庫中拖動視圖來向堆棧添加文本視圖。

第2步

單擊Xcode窗口右上角的加號按鈕（+）打開庫，而後Text在「Turtle Rock」文本視圖後當即將視圖拖到代碼中的位置。

第3步

Text用Joshua Tree National Park替換視圖的佔位符文本。自定義位置以匹配所需的佈局。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             Text("Turtle Rock")
 7                 .font(.title)
 8             Text("Joshua Tree National Park")
 9         }
10     }
11 }
12 
13 struct ContentView_Preview: PreviewProvider {
14     static var previews: some View {
15         ContentView()
16     }
17 }

第4步

將位置的字體設置爲subheadline。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             Text("Turtle Rock")
 7                 .font(.title)
 8             Text("Joshua Tree National Park")
 9                 .font(.subheadline)
10         }
11     }
12 }
13 
14 struct ContentView_Preview: PreviewProvider {
15     static var previews: some View {
16         ContentView()
17     }
18 }

第5步

編輯VStack初始值設定項以按前導對齊視圖。

默認狀況下，堆棧將其內容沿其軸居中，並提供適合上下文的間距。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack(alignment: .leading) {
 6             Text("Turtle Rock")
 7                 .font(.title)
 8             Text("Joshua Tree National Park")
 9                 .font(.subheadline)
10         }
11     }
12 }
13 
14 struct ContentView_Preview: PreviewProvider {
15     static var previews: some View {
16         ContentView()
17     }
18 }

接下來，您將在該位置的右側添加另外一個文本視圖，這是該公園的狀態。

第6步

在畫布上，按住Command鍵點擊約書亞樹國家公園，而後選擇嵌入HStack。

第7步

在位置後添加新文本視圖，將佔位符文本更改成park的狀態，而後將其字體設置爲subheadline。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack(alignment: .leading) {
 6             Text("Turtle Rock")
 7                 .font(.title)
 8             HStack {
 9                 Text("Joshua Tree National Park")
10                     .font(.subheadline)
11                 Text("California")
12                     .font(.subheadline)
13             }
14         }
15     }
16 }
17 
18 struct ContentView_Preview: PreviewProvider {
19     static var previews: some View {
20         ContentView()
21     }
22 }

第8步

要指示佈局使用設備的整個寬度，請經過向包含Spacer兩個文本視圖的水平堆棧添加a 來分隔park和state 。

甲間隔擴展以使其含有視圖中使用它的父視圖的空間的全部，而不是具備其大小僅經過其內容來定義。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack(alignment: .leading) {
 6             Text("Turtle Rock")
 7                 .font(.title)
 8             HStack {
 9                 Text("Joshua Tree National Park")
10                     .font(.subheadline)
11                 Spacer()
12                 Text("California")
13                     .font(.subheadline)
14             }
15         }
16     }
17 }
18 
19 struct ContentView_Preview: PreviewProvider {
20     static var previews: some View {
21         ContentView()
22     }
23 }

第9步

最後，使用padding()修改器方法爲地標的名稱和細節提供一點呼吸空間。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack(alignment: .leading) {
 6             Text("Turtle Rock")
 7                 .font(.title)
 8             HStack {
 9                 Text("Joshua Tree National Park")
10                     .font(.subheadline)
11                 Spacer()
12                 Text("California")
13                     .font(.subheadline)
14             }
15         }
16         .padding()
17     }
18 }
19 
20 struct ContentView_Preview: PreviewProvider {
21     static var previews: some View {
22         ContentView()

4、建立自定義圖像視圖

經過設置名稱和位置視圖，接下來要作的是爲地標添加圖像。

您將建立一個自定義視圖，將遮罩，邊框和陰影應用於圖像，而不是在此文件中添加更多代碼。

首先將圖像添加到項目的資產目錄中。

第1步

在項目文件的Resources文件夾中查找; 將其拖到資產目錄的編輯器中。Xcode爲圖像建立新的圖像集。 turtlerock.png

接下來，您將爲自定義圖像視圖建立一個新的SwiftUI視圖。

第2步

選擇 File > New > File，以再次打開模板選擇器在「 User Interface」部分中，單擊以選中「 SwiftUI視圖」，而後單擊「 Next」。命名文件，而後單擊「 Create」。CircleImage.swift

您已準備好插入圖像並修改其顯示以匹配所需的設計。

第3步

使用Image(_:)初始化程序將文本視圖替換爲Turtle Rock的圖像。

 1 import SwiftUI
 2 
 3 struct CircleImage: View {
 4     var body: some View {
 5         Image("turtlerock")
 6     }
 7 }
 8 
 9 struct CircleImage_Preview: PreviewProvider {
10     static var previews: some View {
11         CircleImage()
12     }
13 }

第4步

添加調用以將圓形剪裁形狀應用於圖像。clipShape(Circle())

的Circle類型是一個形狀，能夠經過賦予圓的行程使用做爲掩模，或做爲視圖或填充。

 1 import SwiftUI
 2 
 3 struct CircleImage: View {
 4     var body: some View {
 5         Image("turtlerock")
 6             .clipShape(Circle())
 7     }
 8 }
 9 
10 struct CircleImage_Preview: PreviewProvider {
11     static var previews: some View {
12         CircleImage()
13     }
14 }

第5步

建立另外一個帶有灰色筆觸的圓，而後將其添加爲疊加層覺得圖像添加邊框。

 1 import SwiftUI
 2 
 3 struct CircleImage: View {
 4     var body: some View {
 5         Image("turtlerock")
 6             .clipShape(Circle())
 7             .overlay(
 8                 Circle().stroke(Color.gray, lineWidth: 4))
 9     }
10 }
11 
12 struct CircleImage_Preview: PreviewProvider {
13     static var previews: some View {
14         CircleImage()
15     }
16 }

第6步

接下來，添加半徑爲10點的陰影。

 1 import SwiftUI
 2 
 3 struct CircleImage: View {
 4     var body: some View {
 5         Image("turtlerock")
 6             .clipShape(Circle())
 7             .overlay(
 8                 Circle().stroke(Color.gray, lineWidth: 4))
 9             .shadow(radius: 10)
10     }
11 }
12 
13 struct CircleImage_Preview: PreviewProvider {
14     static var previews: some View {
15         CircleImage()
16     }
17 }

第7步

將邊框顏色切換爲白色。這樣就完成了圖像視圖。

 1 import SwiftUI
 2 
 3 struct CircleImage: View {
 4     var body: some View {
 5         Image("turtlerock")
 6             .clipShape(Circle())
 7             .overlay(
 8                 Circle().stroke(Color.white, lineWidth: 4))
 9             .shadow(radius: 10)
10     }
11 }
12 
13 struct CircleImage_Preview: PreviewProvider {
14     static var previews: some View {
15         CircleImage()
16     }
17 }

5、一塊兒使用UIKit和SwiftUI視圖

如今您已準備好建立地圖視圖。您可使用MapKit中的類來渲染地圖。MKMapView要UIView在SwiftUI中使用子類，能夠將其餘視圖包裝在符合協議的SwiftUI視圖中。SwiftUI包含WatchKit和AppKit視圖的相似協議。UIViewRepresentable

首先，您將建立一個能夠顯示的新自定義視圖。MKMapView

第1步

選擇 File> New> File，選擇iOS做爲平臺，選擇SwiftUI View模板，而後單擊Next。命名新文件，而後單擊「建立」。MapView.swift

第2步

爲該類型添加import語句，並聲明該類型的一致性。MapKitUIViewRepresentableMapView

不要擔憂Xcode顯示的錯誤; 你將在接下來的幾個步驟中解決這個問題。

該協議有你須要添加兩個要求：一個是建立一個方法，而且該配置視圖和響應任何變化的方法。UIViewRepresentablemakeUIView(context:)MKMapViewupdateUIView(_:context:)

 1 import SwiftUI
 2 import MapKit
 3 
 4 struct MapView: UIViewRepresentable {
 5     var body: some View {
 6         Text("Hello World")
 7     }
 8 }
 9 
10 struct MapView_Preview: PreviewProvider {
11     static var previews: some View {
12         MapView()
13     }
14 }

第3步

使用建立並返回空body的方法替換該屬性。makeUIView(context:)MKMapView

 1 import SwiftUI
 2 import MapKit
 3 
 4 struct MapView: UIViewRepresentable {
 5     func makeUIView(context: Context) -> MKMapView {
 6         MKMapView(frame: .zero)
 7     }
 8 }
 9 
10 struct MapView_Preview: PreviewProvider {
11     static var previews: some View {
12         MapView()
13     }
14 }

第4步

建立一個方法，將地圖視圖的區域設置爲正確的座標，以使地圖在Turtle Rock上居中。updateUIView(_:context:)

當預覽處於靜態模式時，它們僅徹底呈現SwiftUI視圖。由於是子類，因此您須要切換到實時預覽才能看到地圖。MKMapViewUIView

 1 import SwiftUI
 2 import MapKit
 3 
 4 struct MapView: UIViewRepresentable {
 5     func makeUIView(context: Context) -> MKMapView {
 6         MKMapView(frame: .zero)
 7     }
 8 
 9     func updateUIView(_ view: MKMapView, context: Context) {
10         let coordinate = CLLocationCoordinate2D(
11             latitude: 34.011286, longitude: -116.166868)
12         let span = MKCoordinateSpan(latitudeDelta: 2.0, longitudeDelta: 2.0)
13         let region = MKCoordinateRegion(center: coordinate, span: span)
14         view.setRegion(region, animated: true)
15     }
16 }
17 
18 struct MapView_Preview: PreviewProvider {
19     static var previews: some View {
20         MapView()
21     }
22 }

第5步

單擊「實時預覽」按鈕可將預覽切換爲實時模式。您可能須要單擊預覽上方的「重試」或「恢復」按鈕。

片刻以後，你會看到Joshua Tree National Park的地圖，這是龜背巖的故鄉。

6、撰寫詳細信息視圖

您如今擁有了所需的全部組件 - 名稱和位置，圓形圖像以及位置圖。

使用您目前使用的工具，組合您的自定義視圖以建立標誌性詳細視圖的最終設計。

第1步

在項目導航器中，選擇文件。ContentView.swift

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack(alignment: .leading) {
 6             Text("Turtle Rock")
 7                 .font(.title)
 8             HStack {
 9                 Text("Joshua Tree National Park")
10                     .font(.subheadline)
11                 Spacer()
12                 Text("California")
13                     .font(.subheadline)
14             }
15         }
16         .padding()
17     }
18 }
19 
20 struct ContentView_Preview: PreviewProvider {
21     static var previews: some View {
22         ContentView()
23     }
24 }

第2步

嵌入一個VStack將三個文本視圖保存在另外一個視圖中VStack。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             VStack(alignment: .leading) {
 7                 Text("Turtle Rock")
 8                     .font(.title)
 9                 HStack(alignment: .top) {
10                     Text("Joshua Tree National Park")
11                         .font(.subheadline)
12                     Spacer()
13                     Text("California")
14                         .font(.subheadline)
15                 }
16             }
17             .padding()
18         }
19     }
20 }
21 
22 struct ContentView_Preview: PreviewProvider {
23     static var previews: some View {
24         ContentView()
25     }
26 }

第3步

將您的自定義添加到堆棧頂部。設置with 的大小。MapViewMapViewframe(width:height:)

僅指定height參數時，視圖會自動調整其內容的寬度。在這種狀況下，展開以填充可用空間。MapView

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             MapView()
 7                 .frame(height: 300)
 8 
 9             VStack(alignment: .leading) {
10                 Text("Turtle Rock")
11                     .font(.title)
12                 HStack(alignment: .top) {
13                     Text("Joshua Tree National Park")
14                         .font(.subheadline)
15                     Spacer()
16                     Text("California")
17                         .font(.subheadline)
18                 }
19             }
20             .padding()
21         }
22     }
23 }
24 
25 struct ContentView_Preview: PreviewProvider {
26     static var previews: some View {
27         ContentView()
28     }
29 }

第4步

單擊「實時預覽」按鈕以在組合視圖中查看渲染的地圖。

您能夠在顯示實時預覽時繼續編輯視圖。

第5步

將視圖添加到堆棧。CircleImage

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             MapView()
 7                 .frame(height: 300)
 8 
 9             CircleImage()
10 
11             VStack(alignment: .leading) {
12                 Text("Turtle Rock")
13                     .font(.title)
14                 HStack(alignment: .top) {
15                     Text("Joshua Tree National Park")
16                         .font(.subheadline)
17                     Spacer()
18                     Text("California")
19                         .font(.subheadline)
20                 }
21             }
22             .padding()
23         }
24     }
25 }
26 
27 struct ContentView_Preview: PreviewProvider {
28     static var previews: some View {
29         ContentView()
30     }
31 }

第6步

要將圖像視圖疊加在地圖視圖的頂部，請爲圖像提供垂直-130個點的偏移量，並從視圖底部填充-130個點。

這些調整經過向上移動圖像爲文本騰出空間。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             MapView()
 7                 .frame(height: 300)
 8 
 9             CircleImage()
10                 .offset(y: -130)
11                 .padding(.bottom, -130)
12 
13             VStack(alignment: .leading) {
14                 Text("Turtle Rock")
15                     .font(.title)
16                 HStack(alignment: .top) {
17                     Text("Joshua Tree National Park")
18                         .font(.subheadline)
19                     Spacer()
20                     Text("California")
21                         .font(.subheadline)
22                 }
23             }
24             .padding()
25         }
26     }
27 }
28 
29 struct ContentView_Preview: PreviewProvider {
30     static var previews: some View {
31         ContentView()
32     }

第7步

在外部底部添加墊片，將VStack內容推到屏幕頂部。

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             MapView()
 7                 .frame(height: 300)
 8 
 9             CircleImage()
10                 .offset(y: -130)
11                 .padding(.bottom, -130)
12 
13             VStack(alignment: .leading) {
14                 Text("Turtle Rock")
15                     .font(.title)
16                 HStack(alignment: .top) {
17                     Text("Joshua Tree National Park")
18                         .font(.subheadline)
19                     Spacer()
20                     Text("California")
21                         .font(.subheadline)
22                 }
23             }
24             .padding()
25 
26             Spacer()
27         }
28     }
29 }
30 
31 struct ContentView_Preview: PreviewProvider {
32     static var previews: some View {
33         ContentView()
34     }
35 }

第8步

最後，要容許地圖內容擴展到屏幕的上邊緣，請將修改器添加到地圖視圖中。edgesIgnoringSafeArea(.top)

 1 import SwiftUI
 2 
 3 struct ContentView: View {
 4     var body: some View {
 5         VStack {
 6             MapView()
 7                 .edgesIgnoringSafeArea(.top)
 8                 .frame(height: 300)
 9 
10             CircleImage()
11                 .offset(y: -130)
12                 .padding(.bottom, -130)
13 
14             VStack(alignment: .leading) {
15                 Text("Turtle Rock")
16                     .font(.title)
17                 HStack(alignment: .top) {
18                     Text("Joshua Tree National Park")
19                         .font(.subheadline)
20                     Spacer()
21                     Text("California")
22                         .font(.subheadline)
23                 }
24             }
25             .padding()
26 
27             Spacer()
28         }
29     }
30 }
31 
32 struct ContentView_Preview: PreviewProvider {
33     static var previews: some View {
34         ContentView()
35     }
36 }