SwiftUI 提供用于聲明應(yīng)用程序用戶界面的視圖、控件和布局結(jié)構(gòu)

• SwiftUI Document (apple.com)
• SwiftUI 2.0 備忘清單 (swiftui-example)
• Swift 備忘清單 (jaywcjlove.github.io)

import SwiftUI

struct AlbumDetail: View {
  var album: Album
  var body: some View {
    List(album.songs) { song in 
      HStack {
        Image(album.cover)
        VStack(alignment: .leading) {
          Text(song.title)
        }
      }
    }
  }
}

要在UI中顯示文本，只需編寫：

Text("Hello World")

添加樣式

Text("Hello World")
    .font(.largeTitle)
    .foregroundColor(Color.green)
    .lineSpacing(50)
    .lineLimit(nil)
    .padding()

可以設(shè)置URL，單擊后將重定向到瀏覽器。

Link("Click me", destination: URL(string: "your_url")!)

文檔 - Label

創(chuàng)建矩形的步驟

Rectangle()
    .fill(Color.red)
    .frame(width: 200, height: 200)

創(chuàng)建圓的步驟

Circle()
  .fill(Color.blue)
  .frame(width: 50, height: 50)

文檔 - Image

顯示任務(wù)完成進度的視圖。

@State private var progress = 0.5

VStack {
    ProgressView(value: progress)
    Button("More", action: { progress += 0.05 })
}

通過應(yīng)用 CircularProgressViewStyle，可以將其用作 UIActivityIndicatorView。

ProgressView(value: progress)
    .progressViewStyle(CircularProgressViewStyle())

文檔 - ProgressView

將圖像用作背景

Text("Hello World")
    .font(.largeTitle)
    .background(
        Image("hello_world")
            .resizable()
            .frame(width: 100, height: 100)
    )

以垂直線排列其子項的視圖

VStack (alignment: .center, spacing: 20){
    Text("Hello")
    Divider()
    Text("World")
}

創(chuàng)建靜態(tài)可滾動列表。文檔 - VStack

將其子級排列在一條水平線上的視圖。

創(chuàng)建靜態(tài)可滾動列表

HStack (alignment: .center, spacing: 20){
    Text("Hello")
    Divider()
    Text("World")
}

文檔 - HStack

iOS 14 一種視圖，將其子級排列在垂直增長的線中，僅在需要時創(chuàng)建項。

ScrollView {
  LazyVStack(alignment: .leading) {
    ForEach(1...100, id: \.self) {
        Text("Row \($0)")
    }
  }
}

文檔 - LazyVStack

覆蓋其子項的視圖，使子項在兩個軸上對齊。

ZStack {
    Text("Hello")
        .padding(10)
        .background(Color.red)
        .opacity(0.8)
    Text("World")
        .padding(20)
        .background(Color.red)
        .offset(x: 0, y: 40)
}

文檔 - ZStack

一種容器視圖，將其子視圖排列在水平增長的網(wǎng)格中，僅在需要時創(chuàng)建項目。

var rows: [GridItem] =
  Array(
    repeating: .init(.fixed(20)), count: 2
  )

ScrollView(.horizontal) {
  LazyHGrid(rows: rows, alignment: .top) {
    ForEach((0...100), id: \.self) {
      Text("\($0)").background(Color.pink)
    }
  }
}

文檔 - LazyHGrid

沿其包含的堆棧布局的主軸或如果不包含在堆棧中的兩個軸上擴展的靈活空間。

HStack {
    Image(systemName: "clock")
    Spacer()
    Text("Time")
}

文檔 - Spacer

可用于分隔其他內(nèi)容的視覺元素。

HStack {
    Image(systemName: "clock")
    Divider()
    Text("Time")
}.fixedSize()

文檔 - Divider

在打開和關(guān)閉狀態(tài)之間切換的控件。

@State var isShowing = true // toggle state

Toggle(isOn: $isShowing) {
    Text("Hello World")
}

如果您的 Toggle 的標簽只有 Text，則可以使用此更簡單的簽名進行初始化。

Toggle("Hello World", isOn: $isShowing)

文檔 - Toggle

用戶安全地輸入私人文本的控件。

@State var password: String = "1234"    
var body: some View {
  SecureField($password)
    .textFieldStyle(RoundedBorderTextFieldStyle())
    .padding()
}

文檔 - SecureField

可以顯示和編輯長格式文本的視圖。

@State private var fullText: String = "這是一些可編輯的文本..."

var body: some View {
  TextEditor(text: $fullText)
}

設(shè)置 TextEditor 背景顏色

extension NSTextView {
  open override var frame: CGRect {
    didSet {
      backgroundColor = .clear
//      drawsBackground = true
    }
  }
}
struct DetailContent: View {
  @State private var profileText: String = "輸入您的簡歷"
  var body: some View {
    VSplitView(){
      TextEditor(text: $profileText)
        .background(Color.red)
    }
  }
}

文檔 - TextEditor

用于從值的有界線性范圍中選擇一個值的控件。

@State var progress: Float = 0

Slider(value: $progress,
  from: 0.0,
  through: 100.0,
  by: 5.0)

滑塊缺少 minimumValueImage 和 maximumValueImage，但是我們可以通過 HStack 輕松地復制它

@State var progress: Float = 0
HStack {
    Image(systemName: "sun.min")
    Slider(value: $progress,
        from: 0.0,
        through: 100.0,
        by: 5.0)
    Image(systemName: "sun.max.fill")
}.padding()

文檔 - Slider

對于單次敲擊

Text("Tap me!").onTapGesture {
  print("Tapped!")
}

用于雙擊

Text("Tap me!").onTapGesture(count: 2) {
  print("Tapped!")
}

手勢如輕敲手勢、長按手勢、拖拉手勢

Text("Tap")
  .gesture(
      TapGesture()
          .onEnded { _ in
              // do something
          }
  )
Text("Drag Me")
  .gesture(
      DragGesture(minimumDistance: 50)
          .onEnded { _ in
              // do something
          }
  )
Text("Long Press")
  .gesture(
      LongPressGesture(minimumDuration: 2)
          .onEnded { _ in
              // do something
          }
  )

onChange 是一個新的視圖修改器，可用于所有 SwiftUI 視圖。它允許您偵聽狀態(tài)更改并相應(yīng)地對視圖執(zhí)行操作

TextEditor(text: $currentText)
  .onChange(of: clearText) { value in
      if clearText{
          currentText = ""
      }
  }

一個容器，用于顯示排列在單列中的數(shù)據(jù)行。創(chuàng)建靜態(tài)可滾動列表

List {
    Text("Hello world")
    Text("Hello world")
    Text("Hello world")
}

List {
    Text("Hello world")
    Image(systemName: "clock")
}

添加 .listStyle(GroupedListStyle())

List {
  Section(header: Text("UIKit"),
    footer: Text("我們會想念你的")) {
      Text("UITableView")
  }

  Section(header: Text("SwiftUI"),
    footer: Text("要學的東西很多")) {
      Text("List")
  }
}.listStyle(GroupedListStyle())

滾動視圖。

ScrollView(alwaysBounceVertical: true) {
    Image("foo")
    Text("Hello World")
}

文檔 - ScrollView

NavigationView 或多或少類似于 UINavigationController，它處理視圖之間的導航，顯示標題，將導航欄放在頂部。

NavigationView {
    Text("Hello")
        .navigationBarTitle(Text("World"), displayMode: .inline)
}

大標題使用 .large 將條形圖項添加到導航視圖

NavigationView {
  Text("Hello")
      .navigationBarTitle(Text("World"), displayMode: .inline)
      .navigationBarItems(
        trailing:
            Button(
                action: { print("Going to Setting") },
                label: { Text("Setting") }
            )
    )
}

按下時觸發(fā)導航演示的按鈕。這是 pushViewController 的替代品

NavigationView {
    NavigationLink(destination:
        Text("Detail")
        .navigationBarTitle(Text("Detail"))
    ) {
        Text("Push")
    }.navigationBarTitle(Text("Master"))
}

或者通過將組目標添加到自己的視圖 DetailView 中，使其更具可讀性

NavigationView {
    NavigationLink(destination: DetailView()) {
        Text("Push")
    }.navigationBarTitle(Text("Master"))
}

Group 創(chuàng)建多個視圖作為一個視圖，同時也避免了 Stack 的10視圖最大限制

VStack {
    Group {
        Text("Hello")
        Text("Hello")
        Text("Hello")
    }
    Group {
        Text("Hello")
        Text("Hello")
    }
}

Modal 過渡。我們可以顯示基于布爾的 Modal。

@State var isModal: Bool = false

var modal: some View {
    Text("Modal")
}

Button("Modal") {
    self.isModal = true
}.sheet(isPresented: $isModal, content: {
    self.modal
})

文檔 - Sheet

警報演示的容器。我們可以根據(jù)布爾值顯示Alert。

@State var isError: Bool = false

Button("Alert") {
    self.isError = true
}.alert(isPresented: $isError, content: {
    Alert(title: Text("Error"),
      message: Text("Error Reason"),
      dismissButton: .default(Text("OK"))
    )
})

操作表演示文稿的存儲類型。我們可以顯示基于布爾值的 ActionSheet

@State var isSheet: Bool = false

var actionSheet: ActionSheet {
  ActionSheet(title: Text("Action"),
    message: Text("Description"),
    buttons: [
      .default(Text("OK"), action: {
          
      }),
      .destructive(Text("Delete"), action: {
          
      })
    ]
  )
}

Button("Action Sheet") {
    self.isSheet = true
}.actionSheet(isPresented: $isSheet,
  content: {
    self.actionSheet
})

@State var sheetDetail: SheetDetail?

var body: some View {
    Button("Action Sheet") {
        self.sheetDetail = ModSheetDetail(body: "Detail")
    }.actionSheet(item: $sheetDetail, content: { detail in
        self.sheet(detail: detail.body)
    })
}

func sheet(detail: String) -> ActionSheet {
    ActionSheet(title: Text("Action"),
                message: Text(detail),
                buttons: [
                    .default(Text("OK"), action: {
                        
                    }),
                    .destructive(Text("Delete"), action: {
                        
                    })
                ]
    )
}

struct SheetDetail: Identifiable {
    var id: String {
        return body
    }
    let body: String
}

文檔 - ActionSheet