Xcode11发布后,我们一直在惊叹SwiftUI的强大,却忽略了storyboard的一些改进。据我所知,Apple在WWDC期间也没有提到过segue或自定义初始化(initializers)的修改。 我们可以从Xcode和iOS 13发行说明中看到一些修改提示。
SegueAction
假设我们使用storyboards时通过Segue进行页面跳转
左侧的BookController有一个Button,点击该按钮时,它会跳转到右侧的PreviewController,以显示该Book的详情。 使用storyboard,您可以通过从按钮拖拽到目标控制器创建segue实现页面跳转。
要完成segue的配置,必须在属性检查器( attributes inspector)中添加一个唯一标识符(Identifier):
页面跳转时,我们需要将Model数据(本例中的Book)从源传递到目标ViewController。 在Xcode 10和iOS 12中,我们使用源视图控制器中的 prepare(for:sender) 来实现:
// BookController
override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
guard let previewController = segue.destination as? PreviewController else {
fatalError("Missing PreviewController")
}
previewController.book = book
}
注意,我们没有创建目标视图控制器。 UIKit通过调用init(coder:) 方法来初始化新的ViewController。 我们可以配置数据并将其传递给controller,但只能在UIKit创建controller之后。
我的PreviewController有一个Book属性,但它是可选的:
// PreviewController
import UIKit
final class PreviewController: UIViewController {
@IBOutlet private var textView: UITextView!
var book: Book?
override func viewDidLoad() {
super.viewDidLoad()
title = book?.title
textView.text = book?.preview
}
}
book属性是optional的,因为在初始化PreviewController期间无法设置它。我想在创建PreviewController时初始化book,并把book成员变量改成let不可修改的,怎么办呢?
segue是UIKit在调用segue方法期间,创建目标视图控制器的一种方法。
从Xcode 11开始,我们还有另一种将数据传递到目标视图控制器的方法。我们可以通过使用@IBSequeAction在源视图控制器中标记一个方法来创建segue action:
@IBSegueAction
private func showPreview(coder: NSCoder, sender: Any?, segueIdentifier: String?)
-> PreviewController? {
return PreviewController(coder: coder, book: book)
}
SegueAction方法具有三个参数。 必需的NSCoder参数以及可选的sender和segueIdentifier。 如果不需要,我们可以省略可选参数:
@IBSegueAction
private func showPreview(coder: NSCoder)
-> PreviewController? {
return PreviewController(coder: coder, book: book)
}
如果该方法返回nil,则UIKit将调用 init(coder:) 方法来创建视图控制器。 SegueAction不会阻止segue的发生。 无论哪种方式,都会在segue对象中传递新创建的视图控制器给prepare(for:sender)方法。 由于这里我们不再需要它,因此从视图控制器中删除了prepare(for:sender)方法。
注意,Swift 5.1允许我们省略具有单个表达式的方法的return语句,我们进一步简化SegueAction方法:
@IBSegueAction
private func showPreview(coder: NSCoder)
-> PreviewController? {
PreviewController(coder: coder, book: book)
}
要将storyboard中的segue连接到ViewController中的SegueAction方法,请从segue对象向view controller拖动,然后选择SegueAction方法:
如果正确连接了SegueAction,在segue的属性检查器(attributes inspector)中会看到该方法的Selector变成了你定义的方法:
现在,PreviewController可以创建一个自定义initializer方法,该初始化方法在创建视图控制器时 用我们SegueAction传递的Book做参数:
// PreviewController
import UIKit
final class PreviewController: UIViewController {
@IBOutlet private var textView: UITextView!
let book: Book
init?(coder: NSCoder, book: Book) {
self.book = book
super.init(coder: coder)
}
required init?(coder: NSCoder) {
fatalError("init(coder:) has not been implemented")
}
override func viewDidLoad() {
super.viewDidLoad()
title = book.title
textView.text = book.preview
}
}
自定义初始化方法必须调用super.init(coder:) 并传递从SegueAction中接收到的coder参数。 另外,Book属性不再是可选的,因此我们可以将其从var更改为let。
自定时实例化方法
页面跳转时我们可以使用storyboards而不必使用segue。 例如,我可以将按钮连接到视图控制器中的IBAction方法,而不是创建segue:
@IBAction private func showPreview(_ sender: UIButton) {
guard let previewController = storyboard?.instantiateViewController(
withIdentifier: "PreviewController") as? PreviewController else {
fatalError("Unable to create PreviewController")
}
previewController.book = book
show(previewController, sender: self)
}
showPreview方法从storyboard中实例化视图控制器,进行配置然后显示。 这种方式存在与segue相同的一些问题。 我们调用storyboard的instantiateViewController(withIdentifier:)方法,然后返回一个ViewController。 任何Model数据(例如我们的Book)都必须是目标视图控制器的可选属性。
苹果在iOS 13发行说明中对这个问题进行了完善:
You can now invoke a custom initializer from a creation block that’s passed through instantiateInitialViewController(creator:) or instantiateViewController(identifier:creator:).
例如,使用我们的自定义初始化方法传递Model数据:
@IBAction private func showPreview(_ sender: UIButton) {
guard let previewController = storyboard?.instantiateViewController(
identifier: "PreviewController",
creator: { coder in
PreviewController(coder: coder, book: self.book)
}) else {
fatalError("Unable to create PreviewController")
}
show(previewController, sender: self)
}
storyboard.instantiateViewController多了一个creator参数,creator block提供了我们需要传递给自定义view controller初始化方法的coder,现在就把book可选参数改成let了。
迟到总比没有好
未来可能是SwiftUI一统天下,但我仍然很高兴storyboard有所完善。 第一个改动使用Xcode11开发低版本iOS也可以使用,第二个改动就需要iOS13及以上版本支持了。 所以也许这就是迟到总比没有好。
作者:kharrison
翻译整理:乐Coding
原文地址:https://useyourloaf.com/blog/better-storyboards-with-xcode-11/