前提回顾
不知不觉已经到了第七章了,在过往每一个章节中,我们都增加和完成项目的一些功能,让Linkwirld这款产品越来越接近完成品。
一款以用户操作为核心功能的产品,需要包含增删改查4部分功能,在之前的章节中我们已经完成了查看、新增、删除的功能,还缺少对于身份卡进行编辑的功能。编辑操作为用户对于之前创建的内容的调整或者更新,在ToDo、Note等应用当中很是常见。
那么在本章中,我们来完成后编辑相关的操作。
功能分析:新增和编辑页面的区别
很多时候都会有一个疑惑,现在页面和编辑页面到底有没有区别?开发人员究竟只需要维护一个页面还是要维护两个页面?
一般情况下,由于页面样式的相似性,新增和编辑操作在开发的角度上是需要做到共用的。但新增和编辑页面除了数据绑定外没有太大的样式区分时,我们建议可以将样式或者组件抽离出来,然后再单独应用。
视图复用:创建单独的构件
在新增和编辑页面中,我们会发现有几部分视图内容是可以复用的:titleInputView平台输入框、platformPicker平台选择器、indexURLView链接地址。如下图所示:
因此对于这三部分,我们可以将其抽离出来搭建单独的构件,如此便可以在新增页面和编辑页面都可以引用。而且如果需要修改样式,也只需要修改构件的样式,新增和编辑页面的样式就可以统一变化。
我们创建一个新的文件夹,命名为Artifacts,并且创建3个SwiftUI文件,并为其命名为TitleInputView、PlatformPicker、IndexURLView,如下图所示:
我们先来到TitleInputView文件,将原来NewView中的titleInputView视图代码复制过来,如下代码所示:
import SwiftUI
struct TitleInputView: View {
@Binding var title: String
var body: some View {
TextField("请输入头衔", text: $title)
.padding()
.background(Color(.systemGray6))
.cornerRadius(8)
.padding(.horizontal)
.disableAutocorrection(true)
.autocapitalization(.none)
}
}
struct TitleInputView_Previews: PreviewProvider {
static var previews: some View {
TitleInputView(title: .constant(""))
}
}
上述代码中,除了TextField输入框相关代码复制过来,我们还需要完善相关的绑定参数。声明一个用于双向绑定输入框的参数title,并且在TitleInputView预览时给参数赋予默认值。
紧接着来到PlatformPicker视图,将原来NewView中的platformPicker视图代码复制过来,如下代码所示:
import SwiftUI
struct PlatformPicker: View {
@Binding var platformIcon: String
@Binding var platformName: String
let platforms = [
("稀土掘金技术社区", "icon_juejin"),
("CSDN博客", "icon_csdn"),
("阿里云社区", "icon_aliyun"),
("华为云社区", "icon_huaweiyun"),
]
var gridItemLayout = [GridItem(.flexible()), GridItem(.flexible()), GridItem(.flexible()), GridItem(.flexible())]
var body: some View {
ScrollView {
LazyVGrid(columns: gridItemLayout, spacing: 10) {
ForEach(0 ..< platforms.count, id: .self) { item in
if platforms[item].0 == platformName {
Image(platforms[item].1)
.resizable()
.aspectRatio(contentMode: .fit)
.frame(width: 48, height: 48)
.clipShape(Circle())
.overlay(
Circle()
.stroke(Color.green, lineWidth: 4)
)
} else {
Image(platforms[item].1)
.resizable()
.aspectRatio(contentMode: .fit)
.frame(width: 48, height: 48)
.clipShape(Circle())
.onTapGesture {
platformIcon = platforms[item].1
platformName = platforms[item].0
}
}
}
}
}
.padding()
.background(Color(.systemGray6))
.cornerRadius(8)
.padding(.horizontal)
.frame(maxHeight: 140)
}
}
struct PlatformPicker_Previews: PreviewProvider {
static var previews: some View {
PlatformPicker(platformIcon: .constant("icon_juejin"), platformName: .constant("稀土掘金技术社区"))
}
}
上述代码中,我们仍旧讲需要声明双向绑定的变量,如:platformIcon平台图标、platformName平台名称,值得注意的是,原有我们声明的selectedItem完全可以换成判断platformName是否等于点击的名称,减少一个参数。如下代码所示:
platforms[item].0 == platformName
声明双向绑定变量还需要在预览PlatformPicker时增加参数的默认值,如下代码所示:
PlatformPicker(platformIcon: .constant("icon_juejin"), platformName: .constant("稀土掘金技术社区"))
下一步到IndexURLView视图,将原来NewView中的indexURLView视图代码复制过来,如下代码所示:
import SwiftUI
struct IndexURLView: View {
@Binding var indexURL:String
var body: some View {
ZStack(alignment: .topLeading) {
TextEditor(text: $indexURL)
.font(.system(size: 17))
.padding(15)
.disableAutocorrection(true)
.autocapitalization(.none)
if indexURL.isEmpty {
Text("请输入主页链接")
.foregroundColor(Color(UIColor.placeholderText))
.padding(20)
}
}
.background(Color(.systemGray6))
.cornerRadius(8)
.padding()
.frame(maxHeight: 240)
}
}
struct IndexURLView_Previews: PreviewProvider {
static var previews: some View {
IndexURLView(indexURL: .constant(""))
}
}
完成之后,我们就可以回到NewView视图中,将原来的参数以及titleInputView平台输入框视图、platformPicker平台选择器视图、indexURLView链接地址视图的代码删掉,如下图所示:
删除代码后,我们使用单独搭建的构件来重新搭建样式,如下代码所示:
TitleInputView(title: $title)
PlatformPicker(platformIcon: $platformIcon, platformName: $platformName)
IndexURLView(indexURL: $indexURL)
如此,NewView视图在维持原有功能样式不变的情况下,代码量也精简很多。
界面设计:创建EditView编辑页面
完成单独的构件后,我们就可以来完成编辑页面的设计。创建一个新的SwiftUI文件,命名为EditView,如下图所示:
我们先搭建基础的样式,示例:顶部导航菜单、页面标题、关闭按钮等等,如下图所示:
import SwiftUI
struct EditView: View {
@Environment(.presentationMode) var presentationMode
var body: some View {
NavigationStack {
Text("Hello, World!")
.navigationBarTitle("编辑身份卡", displayMode: .inline)
.navigationBarItems(trailing: closeBtn())
}
}
// 关闭按钮
func closeBtn() -> some View {
Button(action: {
self.presentationMode.wrappedValue.dismiss()
}) {
Image(systemName: "xmark.circle.fill")
.font(.system(size: 17))
.foregroundColor(.gray)
}
}
}
上述代码中,我们基本和NewView页面的设计一样,使用NavigationStack搭建顶部导航菜单,并使用navigationBarTitle修饰符设置导航标题,使用navigationBarItems修饰符设置关闭页面按钮,并通过声明全局变量presentationMode和搭建单独的关闭按钮closeBtn来实现关闭编辑页面。
对于编辑保存按钮,样式和操作和NewView页面可能不一样,我们也单独构建按钮,如下代码所示:
// 编辑更新按钮
func updateBtn() -> some View {
Button(action: {
self.presentationMode.wrappedValue.dismiss()
}) {
Text("确定更新")
.font(.system(size: 17))
.foregroundColor(.white)
.bold()
.padding()
.frame(maxWidth: .infinity)
.background(Color.blue)
.cornerRadius(8)
.padding(.horizontal)
}
}
完成后将编辑按钮updateBtn添加到EditView编辑页面视图中,如下代码所示:
VStack(spacing: 15) {
updateBtn()
}
在引用构件之前,我们先来理解下数据关系。
EditView编辑页面和ContentView主页的数据关系是,用户在ContentView主页点击单张身份卡片,然后打开EditView编辑页面,并将ContentView主页身份卡片的数据传递到EditView编辑页面。
我们可以声明一个符合Model数据模型的参数,然后无论是TitleInputView、PlatformPicker、IndexURLView的参数都绑定Model数据模型的参数,然后该数据模型双向绑定到ContentView主页中,就可以将ContentView主页的数据传递过来,如下代码所示:
@State var model: Model
然后调用TitleInputView、PlatformPicker、IndexURLView构件,并且绑定model模型的值,如下代码所示:
VStack(spacing: 15) {
TitleInputView(title: $model.title)
PlatformPicker(platformIcon: $model.platformIcon, platformName: $model.platformName)
IndexURLView(indexURL: $model.indexURL)
updateBtn()
Spacer()
}
交互动作:打开EditView编辑页面
完成后,我们回到ContentView主页中,我们来实现页面跳转的逻辑。首先我们先声明一个用于页面跳转的参数,如下代码所示:
@State var showEditView: Bool = false
然后在CardView视图中增加页面跳转的方法,这里也可以使用Sheet修饰符,如下代码所示:
// 打开编辑弹窗
.sheet(isPresented: self.$showEditView, onDismiss: {self.showEditView = false }) {
EditView(model: self.item ?? Model(platformIcon: "", title: "", platformName: "", indexURL: ""))
}
上述代码中,我们使用sheet修饰符用户打开模态弹窗,触发操作绑定声明好的变量showEditView,打开的模态弹窗的页面为EditView编辑页面。
由于EditView编辑页面需要传入参数,这里我们选择传入的对应model的参数为声明的item,当item不存在时,则默认传入一个符合Model格式的数据,避免报错。
对于编辑操作,我们可以给CardView增加多一个指示符,告知用户这个卡片是可以被编辑的,如下代码所示:
Image(systemName: "ellipsis")
.padding()
.foregroundColor(.black)
.gesture(
TapGesture()
.onEnded({
self.showEditView.toggle()
})
)
上述代码中,我们增加了一个Image图片到CardView视图中,当点击这个Image图片时,打开EditView编辑页面。
考虑到在ContentView我们已经使用NavigationLink顶部导航菜单进行跳转,那么如果我们给按钮增加点击事件,会存在两个点击事件冲突的情况。
我们先注释掉NavigationLink相关的代码,如下图所示:
完成后,我们点击刚刚创建的编辑按钮,预览下效果,如下图所示:
新增功能:编辑并更新内容
完成样式后,我们来实现下编辑更新的逻辑,来到ViewModel视图模型中,我们创建一个编辑并更新的方法,如下图所示:
// 编辑更新数据项
func editItem(item: Model) {
if let id = models.firstIndex(where: { $0.id == item.id }) {
models[id] = item
}
}
编辑操作很简单,首先要找到点击编辑的数据项的ID在整个models数据集中的位置,更新后将更新内容赋予当前的ID,便实现了编辑更新操作。
回到EditView视图中,先引入ViewModel视图模型,如下代码所示:
var viewModel: ViewModel
然后在EditView视图预览时,给声明的viewModel赋予默认值,如下代码所示:
EditView(model: Model(platformIcon: "", title: "", platformName: "", indexURL: ""), viewModel: ViewModel())
由于我们在EditView视图声明了变量viewModel,因此在使用EditView视图的页面也要进行参数绑定。
我们来到ContentView文件,在CardView视图中,需要补充viewModel相关的参数,如下图所示:
绑定完成后,我们再回到EditView视图,在点击updateBtn更新按钮时,调用ViewModel视图模型中的editItem方法,如下代码所示:
self.viewModel.editItem(item: model)
如此,我们便实现了编辑更新的方法。
交互动作:打开HonePageView页面
完成打卡编辑弹窗,并实现编辑更新操作后,我们来补充完善下打开HonePageView页面的交互。在之前的章节我们使用NavigationLink导航菜单跳转方式实现了页面跳转,由于会和我们点击编辑操作相冲突,因此我们注释了这部分代码。
这里我们再介绍一种弹窗,fullScreenCover全屏覆盖弹窗,用fullScreenCover也可以实现页面跳转的效果。
首先先声明打开弹窗的变量,我们在CardView视图中声明变量,如下代码所示:
@State var showHomePageView: Bool = false
然后实现调用fullScreenCover全屏覆盖弹窗的方法,如下代码所示:
//打开身份卡主页
.fullScreenCover(isPresented: $showHomePageView, content: {
HomePageView(platformName: platformName, indexURL: indexURL)
.edgesIgnoringSafeArea(.all)
})
上述代码中,我们给CardView的主要内容增加了fullScreenCover修饰符,用于打开全屏覆盖弹窗。
弹窗打开触发动作绑定声明好的参数showHomePageView,目标地址选择HomePageView,并且绑定相关的参数,我们希望这个弹窗全屏展示,增加了edgesIgnoringSafeArea忽略安全区域修饰符。
打开弹窗的操作,我们希望点击身份卡片时打开,但又不能和编辑按钮相冲突。
我们可以将平台图标、平台称号、平台名称部分的样式再使用一个容器包裹起来,点击这个容器打开HomePageView页面,这样就可以做到不和编辑按钮相冲突了。如下图所示:
最后我们增加点击事件在这个容器中,当点击时打开fullScreenCover弹窗,如下代码所示:
.gesture(
TapGesture()
.onEnded({
self.showHomePageView.toggle()
})
)
由于fullScreenCover弹窗是由下往上打开,因此我们可以换一个返回按钮的样式,让操作看起来流畅些,如下图所示:
项目预览
完成后,我们在模拟器中预览下效果,如下图所示:
项目小结
在本章中,我们实现了EditView页面的界面设计、页面跳转、编辑更新方法,单一个编辑操作就很不容易,哭泣。
但最重要的是学习了结构化编程方法,将页面的元素分块,然后抽离创建单独的构件,如此不管在新增页面还是在编辑页面,我们都只需要维护一套代码,这大大减轻了代码量,也使得编程更加优雅。
那么对于一个本地项目来说,linkworld已经完成了查看、新增、编辑、删除操作,似乎可以告一段落了。但是,如果一款产品要成功上线AppStore,那么仅仅在模拟器中使用这些功能是远远不够的,我们还需要进行本地化存储等功能的开发等等工作。
那么在下一章中,我们将介绍如果实现本地存储及远端数据存储相关的内容,请保持期待吧~
版权声明
本文为稀土掘金技术社区首发签约文章,14天内禁止转载,14天后未获授权禁止转载,侵权必究!