SwiftUI - 一起来仿写微信APP之一首页列表视图

简介

最近在学习 SwiftUI ，我一般都是先去学习界面布局，所以就想着仿写一下经常使用的软件的界面，所以先拿微信开刀。因为不想一次性发太多的内容，所以只好将主题分解，一部分一部分地去讲，接下来我们一起来学习吧。

如果你尝试过使用 SwiftUI 编写界面，你会发现是如此地舒心，我已深深地爱上了它。当然它的坑并不少，毕竟才刚出来，最低支持系统是 iOS13，估计还得等个几年才会慢慢在公司里使用上吧。但是这并不妨碍我们的学习。

在这篇文章里，我会一步一步编写微信的首页列表视图，一步一步将代码呈现上来，并仔细地讲解，我相信你们都可以看懂的，先来看看效果图。

image

很简单吧？是很简单，但是在编写的时候还是有些技巧在里面，毕竟，简单才不容易劝退嘛。在开始前先讲一下这篇文章将会用到的一些布局与组件，先给大家一个印象，方便后面的阅读理解。

HStack - 水平布局

VStack - 垂直布局

Text - 文本控件

Spacer - 扩展空间，使容器填满布局空间

Image - 图像控件

List - 列表控件

Divider - 分隔线控件

工作环境

Xcode - Version 11.3.1 (11C504)

Swift - version 5.1.3 (swiftlang-1100.0.282.1 clang-1100.0.33.15)

开始编写代码

编写列表行

我们来先把头像添加进来。

Image("1")
    .resizable() // 1
    .frame(width: 46, height: 46) // 2
    .cornerRadius(6)// 3

1 - 在 SwiftUI 中，如果需要控制图像的大小，则必须先调用resizable修饰

2- 设置图像大小

3 - 设置圆角大小，四个角的大小都相同

因为布局是横向的，所以我们在外层使用HStack包裹起来，然后添加联系人名字和最后发消息时间。

HStack {
    // 头像

    HStack {
        Text("女神")
            .font(.body) // 1

        Spacer()

        Text("下午 2:55")
            .font(.caption)
            .foregroundColor(Color.gray.opacity(0.5)) // 2
    }
}

1 - 使用 font 修饰字体，这里使用了苹果提供的标准字体，苹果还提供了 largeTitle, title, headline, subheadline, body, callout, footnote, caption。

2 - 使用 foregroundColor 修饰字体颜色，因为 gray 的灰色还是太黑了，所以这里又使用了 opacity 去修饰透明度为50%，使它显得更淡一点。

名字下方显示的是是最后发送或接收的消息内容，因此我们在外层使用 VStack 包裹起来。

VStack(alignment: .leading, spacing: 6) { // 1
    // 名称和时间

    Text("对不起，你是个好人")
        .font(.callout)
        .foregroundColor(Color.gray)
}

// 1 - 设定VStack里子控件居左对齐，默认是居中对齐。再设定子控件的间隙为 6 个像素，这样比较符合微信上面的设计。

现在样子已经出来了，我们先预览下效果。

image

我们给最外层的HStack增加padding，使它更美观一些，参数填写.all代表四周都需要边框。经过我的眼力观察，它的默认是 16px 的样子。

HStack {
    // 头像、名称、时间、消息内容
}
.padding(.all)

有了间距，好看多了。

image

接下来创建一个视图，它负责装载行视图，起名为GCMainRow。

struct GCMainRow: View {
    var body: some View {
        HStack {
            Image("1")
                .resizable()
                .frame(width: 46, height: 46)
                .cornerRadius(6)
            
            VStack(alignment: .leading, spacing: 6) {
                HStack {
                    Text("女神")
                        .font(.body)

                    Spacer()

                    Text("下午 2:55")
                        .font(.caption)
                        .foregroundColor(Color.gray.opacity(0.5))
                }
                Text("对不起，你是个好人")
                    .font(.callout)
                    .foregroundColor(Color.gray)
            }
        }
        .padding(.all)
    }
}

然后在ContentView改为调用GCMainRow()，这样代码就好看很多了。

struct ContentView: View {
    var body: some View {
        GCMainRow()
    }
}

编写列表 List

好了，现在让我们来编写列表视图吧。我们在最外层使用List包裹GCMainRow，循环 20 个视图，数据多点才可以让我们滚动。

List(0 ..< 20) { _ in // 1
    GCMainRow()
}

1 - 因为我们不需要用到循环的一些数据，所以我们使用 _ 去忽略它。

List控件默认的都会有边距，下图黄色是GCMainRow的大小，可以看得出来旁边有空白的填充，这对我们当前的设计来说不太友好，因此我们需要想办法去掉这些边距填充。

image

List提供了listRowInsets来控制行的边距（上下左右），我们来试着使用一下。

List(0 ..< 20) { item in
    GCMainRow()
        .listRowInsets(EdgeInsets())
}

我们发现，这样写是没有作用的，listRowInsets的生效条件是“不能直接在List中使用，需要配合For Each语句才能生效”，我们再修改一下代码。

List {
    ForEach(0 ..< 20) { item in
        GCMainRow()
            .listRowInsets(EdgeInsets())
    }
}

好了，这次生效了，这就是我们要的结果。

image

自定义分隔线

我们仔细观察一下分隔线，在微信里分隔线是左对齐在名称和消息内容的，所以我们需要把现有的分隔线隐藏掉，然后再实现它。

在这里讲解一下，List是基于UITableView去实现的，这意味着我们可以通过appearance全局修改它的所有属性，正如我们现在需要取消它默认的分隔线，将separatorStyle设置为.none即可。

init() {
    UITableView.appearance().separatorStyle = .none
}

因为分隔线是贴着右边缘的，所以我们需要在包裹着名称、时间、消息内容的VStack外层再包裹一层VStack，在其中再添加分隔线Divider，并将里层的VStack设定右边距，最后将最外层的HStack的padding改为上和左边距。是不是听得有点懵？没关系，看看代码就很容易理解了。

HStack(alignment: .top) { // edit
    // 头像
    VStack { // new
        VStack(alignment: .leading, spacing: 6) {
            // 名称、时间、消息内容
        }
        .padding(.trailing) // new
        Divider() // new
    }
}
.padding(.top) // edit
.padding(.leading) // edit

我们现在来看一下效果。

image

未读消息小红点

未读消息在头像的右上方，小红点的中心点是位于头像的右上顶端。我们可以使用overlay叠加一个视图，来制作小红点吧。

Image("1")
        // ...
    .overlay(
        Color.red // 1
            .frame(width: 16, height: 16)
            .cornerRadius(8)
            .offset(x: 23, y: -23) // 2
)

// 1 - Color 本身也是一个视图组件，这是官方的定义 @available(iOS 13.0, OSX 10.15, tvOS 13.0, watchOS 6.0, *) extension Color : View { }

// 2 - 设定视图的偏移量，那么23是怎样得出来的呢？很简单，因为默认的overlay视图是位于父视图的中心，那么我们要将它放置在右上角，那么只需要宽高都除以2就可以了，那么这里的结果就是，x轴增加23px，y轴减少23px

接下来是未读数量，和上面的相似，在Color视图上利用overlay叠加Text视图就可以了。

Color.red
    .overlay( // 1
        Text("1")
            .font(.caption)
            .foregroundColor(.white)
)
    .frame(width: 16, height: 16)
    .cornerRadius(8)
    .offset(x: 23, y: -23)