提供用于聲明應用程(cheng)序用戶界面(mian)的視圖、控件和布局(ju)結構

• (apple.com)
• (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)
        }
      }
    }
  }
}

要在(zai)UI中(zhong)顯(xian)示文本，只需編寫：

Text("Hello World")

添加樣式

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

可(ke)以(yi)設置(zhi)URL，單(dan)擊后將重定向到瀏(liu)覽器。

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

文檔 -

創建矩形的步驟

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

創建圓的步驟

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

文檔 -

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

@State private var progress = 0.5

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

通過應用 CircularProgressViewStyle，可以將其用作 UIActivityIndicatorView。

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

文檔 -

將圖像用作背景

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

以(yi)垂(chui)直(zhi)線排列其(qi)子(zi)項的視圖

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

創建靜(jing)態(tai)可滾動列表。文檔 -

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

創建靜態可滾動列表

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

文檔 -

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

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

文檔 -

覆蓋(gai)其(qi)子項的視圖(tu)，使子項在兩個軸上對齊。

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

文檔 -

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

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

文檔 -

沿(yan)其(qi)包(bao)含的(de)堆棧布局(ju)的(de)主軸(zhou)或(huo)如(ru)果(guo)不包(bao)含在堆棧中的(de)兩個軸(zhou)上(shang)擴展的(de)靈活空間。

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

文檔 -

可用(yong)于分隔其他內容的視(shi)覺元素。

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

文檔 -

在打開(kai)和關閉狀態(tai)之(zhi)間(jian)切換(huan)的(de)控件。

@State var isShowing = true // toggle state

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

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

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

文檔 -

用戶安全地輸入私人文本的(de)控件(jian)。

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

文檔 -

可(ke)以顯(xian)示(shi)和編輯長格式文(wen)本的視圖(tu)。

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

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

設置 TextEditor 背景顏色

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

文檔 -

用于(yu)從值(zhi)的(de)有(you)界線性范(fan)圍(wei)中選擇一(yi)個值(zhi)的(de)控件。

@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()

文檔 -

對于單次敲擊

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

用于雙擊

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

手勢如輕(qing)敲手勢、長按手勢、拖拉手勢

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 是一(yi)個新的視(shi)(shi)圖修改器，可用于(yu)所有 SwiftUI 視(shi)(shi)圖。它允許您偵聽狀態更(geng)改并相應地對視(shi)(shi)圖執(zhi)行操作

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

一個容器，用于顯示(shi)排(pai)列在(zai)單(dan)列中的數據行。創建靜態可滾動列表

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("要學的(de)東西很多")) {
      Text("List")
  }
}.listStyle(GroupedListStyle())

滾動視圖。

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

文檔 -

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

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

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

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

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

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

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

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

Group 創建多個(ge)視(shi)圖作為一個(ge)視(shi)圖，同時也避免了 Stack 的(de)10視(shi)圖最(zui)大(da)限制

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

Modal 過渡。我們可以(yi)顯示基于布(bu)爾的 Modal。

@State var isModal: Bool = false

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

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

文檔 -

警(jing)報演示的(de)容器。我們可(ke)以(yi)根據布爾值顯(xian)示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
}

文檔 -