剖析:如何用 SwiftUI 5天写一个微信 —— 聊天界面篇

2021年7月21日 1点热度 0条评论 来源: wavky

前置资源

GitHub: SwiftUI-WeChatDemo

第零章:用 SwiftUI 五天组装一个微信 - wavky - 博客园

整体结构

UI 部分代码分布如上图所示,App 的主入口类为 WeChatDemoApp。

该类在创建新的 SwiftUI 项目时会自动生成,这里只需要将其展示内容部分变更为第一级容器:TabContainer,该容器包括微信的四个页面,分别为 聊天界面部分、通讯录、发现、我,这四个部分的主 UI 视图分布如上图标示,由各自的文件夹装载,并统合到主目录 UI 下面。

与 UI 目录同级目录有:

  • Data:相当于 MVVM 中的 Repository 层级的简单替代,因为该项目主要展示 SwiftUI 使用,因此该层最大限度精简,只提供装载必要数据的类
  • Resources:资源目录,包括 Image.xcassets、Color.xcassets、Localizable.strings 等
  • Generated:通过 SwiftGen 自动为 Resources 目录生成的资源索引类目录,主要是为了给代码编写提供自动提示的便利,提高工作效率,适配 SwiftUI 的配置及使用可参考 SwiftGenConfigForSwiftUI

UI 层级示意图:

WeChatDemoApp
└── TabView
    ├── ChatsView
    │   └── ChatDetailView
    ├── ContactsView
    ├── DiscoverView
    └── MeView

第一级容器:TabView

App 之下的第一级容器,使用的是 TabView,并通过自定义结构体 TabContainer 将其包裹封装,实现代码分离。

TabView 需要提供一个参数 selection,类型可随意自定义,用于告诉 TabView 在初始化后应该展示哪个 Tab,以及当用户选择其他 Tab 时,将其反馈、存储到该变量中。

该变量需要声明为 @State 类型,以实现 UI 视图感应数据变化,自动刷新的功能(数据绑定)。(同样,语法上需要以 $ 的前缀方式将变量注入到 selection 参数)

其他如 Picker 等可提供用户选择能力的 UI,也都需要与一个 selection 变量进行绑定。

在 TabView 下面按序放置四个 View 视图,代表提供了 4 个 Tab 的界面,结构如下:

ChatsView().tabItem {
    Image(systemName: currentStateIconName(selecting: selectingTab))
    Text("Chats")
}.tag(Tabs.Chats)

func currentStateIconName(selecting: Tabs) -> String {
    selecting == self ? iconNameOn : iconNameOff
}
  • 示例中自定义 ChatsView 为第一个 Tab 的视图 View
  • .tabItem { ... } 用于描述 Tabbar 上该 Tab 按钮的 UI 部分,仅可接受标准的 Image、Text 以及 Label 类型
  • .tag(...) 表示该 Tab 的识别符号,类型上需要与上面的 selection 变量一致,用户点击 Tab 按钮时,该处的 tag 变量会被赋值到 selection 中
  • 为了实现 Tab 按钮在激活・非激活状态下展示不同的图标(实心与空心),此处将一个根据 selecting 参数返回对应图片名字的函数传递到 Image 中,当 @State var selectingTab 变量发生变化时,相关联的 UI 将会重绘,并重新调用函数获取新的图片名字

最后通过对 TabView 添加 .edgesIgnoringSafeArea(.all),使其可用空间扩展到刘海顶部实现全屏。

Tab 1:聊天列表

整一个 Tab 的根容器是一个 NavigationView,该部件提供了标准的 Toolbar、子页面跳转、返回等功能。

在 NavigationView 之中包裹的是真正的视图布局。

视图布局三剑客

  • HStack:提供一个横向的自动布局容器,默认 UI 元素自左向右排布
  • VStack:提供一个纵向的自动布局容器,默认 UI 元素自上向下排布
  • ZStack:提供一个沿 Z 轴排布的布局容器,后面的 UI 元素将覆盖前面的 UI 元素(相当于 Android 中的 FrameLayout)
    (※ 这三个容器默认带有元素间距,可使用参数 spacing: 0 消除)

界面上,排除由 NavigationView 提供的 Toolbar 部分,视图由一个自定义的搜索栏 SearchBar,以及一个列表,通过 VStack 纵向排列而成。

列表部分可使用 SwitchUI 中专用的 ForEach,实现一个根据数据数组元素数量、内容,不断添加 UI 元素的循环结构。(也可以考虑使用 List,但 List 带有比较强烈的样式倾向,不如 ForEach 容易控制)

ForEach([Chat], id: \.self) { chat in
    NavigationLink(destination: createChatDetailView(with: chat)) {
        ChatItemView(chat: chat)
    }
}

※ 不能使用普通的 for 语法

ForEach 要求提供的数据类型遵循 Hashable 协议,同样 id 也要求提供 Hashable,以便其识别、追踪每次循环所生成的 View,在数据发生变化时能够在正确位置插入、删除、修改对应的 UI。

id: \.self 使用的是一种名为 KeyPath 的类型及语法糖,该语法从 Swift5.2 开始提供,描述了一个从参数类型 KeyPath 所声明绑定的 Root 泛型类型对象中获取指定的某个属性的路径,可类比于 Java 的反射或 JS 的 eval 功能等,提供了将某个属性访问的动态操作转换为另一种体现在某个属性值上的静态描述能力。

此处 \.self 表示,id 参数使用前面的数组中 Chat 元素自身,相当于 chat.self

NavigationLink(destination: createChatDetailView(with: chat)) {
    ChatItemView(chat: chat)
}

上述代码中,ForEach 根据 Chat 数组,生成聊天列表中每一个聊天记录项的 View,该 View 由 NavigationLink 所包裹,当用户点击该 View 时,将自动通过外层的 NavigationView 进行页面导航,跳转至此处指定的 destination 指向的 View(作为子页布局展示)。

NavigationLink { ... } 中的 UI 则是这个聊天记录项的布局(list item)。

.navigationBarTitleDisplayMode(.inline)
.navigationTitle("微信")
.toolbar {
    ToolbarItem(placement: .navigationBarLeading){
        Button(action: {}) {
            Image(systemName: "ellipsis")
        }
    }
    ...
}

这些部分描述当前界面的顶部的 Title 展示形式、字符串资源、Toolbar构成等。

需要注意的是这部分描述需要在 NavigationView 内的元素上书写,而不是附加在 NavigationView 自身上。

聊天记录 View

Spacer 是一个可以依据剩余控件自动填充的结构,用于自动撑开两个 View 或将容器撑满整个屏幕等。

let isShowBadge: Bool = Float.random(in: 0...1) > 0.45

Image("avatar01")
    .resizable()
    .scaledToFit()
    .frame(width: 50, height: 50, alignment: .center)
    .cornerRadius(4.0)
    .withBadge(isShowBadge)

头像部分,显示一个图片素材,指定其可缩放至指定 frame 大小,并追加圆角角度,最后的 withBadge(isShowBadge) 为自定义函数扩展:

该函数通过为 View 添加一个圆形的 overlay,并指定放置在右上角并偏移一半尺寸到 View 外侧,来实现信息红点功能。

函数返回类型指定为 some View,属于 SwiftUI 中类型擦除的概念,在函数中使用 if、switch 等根据情况返回不同 View 的场合,需要使用 AnyView 进行包裹并返回,否则将出现代码检测错误:

Function declares an opaque return type, but the return statements in its body do not have matching underlying types

分割线可用 Divider() 实现。

聊天窗口

@State var chat: Chat
@StateObject var viewModel: ChatDetailViewModel
@Environment(\.presentationMode) var presentationMode
  • @State chat:一个 struct 类型,包含对方最后一条聊天消息和联系人(头像)信息
  • @StateObject viewModel:用于承载复杂的使用场景,在该界面上 ChatDetailViewModel 托管了一个发送消息记录的数组,以及通过 Combine 响应式框架模拟聊天对方在 1 秒后回信的功能
  • @Environment presentationMode:从环境变量中获取当前的界面的展开模式控制对象,用于在 Toolbar 中赋予自定义返回按钮的返回聊天列表能力

界面主体由两大部分组成:

  • 聊天信息记录的 ChatFlowView
  • 底部文字输入部分的 ChatInputView

ChatFlowView 根据由 ViewModel 所托管的消息记录 messageFlow 数组数据,使用 ForEach 生成每一条对话消息:

ScrollViewReader 用于提供对 ScrollView 的滑动控制能力,在不需要程序自动控制 ScrollView 滑动时,则不需要使用该部件。

ChatMessageView(message: message).onAppear() {
    scrollView.scrollTo(message)
}

ChatMessageView 表示头像+信息组成的一条聊天信息,使用一个 ChatMessage 类型的数据进行初始化,数据包含聊天信息内容的 String,以及发送方向、头像。

MessageText 基本上是一个普通 Text,展示 ChatMessage 中的信息内容,并根据其中的发送方向(左侧或是右侧)决定 Text 的底色。

在外层 HStack 上通过改写局部环境变量 layoutDirection,来实现布局排序方向变化。

    原文作者:wavky
    原文地址: https://www.cnblogs.com/wavky/p/SwiftUI-WeChatDemo-Coding-Chat.html
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系管理员进行删除。