前言
NS_CLASS_AVAILABLE_IOS(5_0) @interface UIStoryboard : NSObject
@available(iOS 5.0, *) public class UIStoryboard : NSObject
StoryBoard 是苹果在 iOS5 中引入的新技术方案,目的是给纷繁复杂的 nib、xib 们一个温暖的家,让他们之间的关系更直观地展示出来,并提供了一种新的页面间跳转方式 Segue。StoryBoard 的本质是一个 XML 文件,描述了若干窗体、组件、Auto Layout 约束等关键信息。Storyboard 不止是包含一个视图控件,而是所有的视图控件以及他们之间的关系。
Storyboard 对一个视图的官方术语是一个场景,但是一个场景其实就是一个 ViewController,用来描述软件界面,在 iPhone 中一次只能够展示一个场景,而在 iPad 中一次可以展示多个场景。一个项目中可以有不止一个 StoryBoard 文件,它们之间可以互相调用。
使用 StoryBoard 的 iOS 项目均以初始化 StoryBoard 文件作为整个程序的初始化入口,UIViewController 类是由于被 StoryBoard 绑定而初始化,从而开始运行的。
1、StoryBoard
1.1 StoryBoard 视图界面
- 加载 StoryBoard 时会首先创建和显示箭头所指的控制器界面。
1.2 Storyboard 到代码的转换
-
代码编译时编译器会自动将 Storyboard 转换为相应的代码。
- 上图设置自动转换为:
// 创建一个自定义的按钮 UIButton *btn = [UIButton buttonWithType:UIButtonTypeCustom]; // 默认状态的文字 [btn setTitle:@"点我啊" forState:UIControlStateNormal]; // 默认状态的文字颜色 [btn setTitleColor:[UIColor redColor] forState:UIControlStateNormal]; // 默认状态的背景 [btn setBackgroundImage:[UIImage imageNamed:@"btn_01"] forState:UIControlStateNormal];
2、StoryBoard 界面设置
-
1)启动 StoryBoard 设置
-
修改 TARGETS => General => Development Info => Main Interface 的值。或者修改 Info.plist 文件中键 Main storyboard file base name 对应的值可以修改程序启动时加载的 StoryBoard。
这个设置表明:程序启动时会加载 Main.storyboard
-
-
2)View Controller 设置
-
Identity 设置面板
Custom Class . -- Class StoryBoard 绑定的视图控制器 -- Module Identity -- StoryBoard ID StoryBoard 的 ID -- Restoration ID --- Use StoryBoard ID 设置是否使用 StoryBoard ID -
Attributes 设置面板
Simulated Metrics . -- Size 屏幕尺寸 --- Inferred 自动推断 --- Freeform 自定义 --- Page Sheet --- Form Sheet --- Master 主控制页 --- Detail 详情页 -- Orientation 屏幕方向 --- Portrait 竖屏 --- Landscape 横屏 -- Status Bar 状态栏 -- Top Bar 顶部控制条 -- Bottom Bar 底部控制条 View Controller -- Title --- Is Initial View Controller 设为初始场景,场景前面会显示灰色的小箭头,程序启动后会将这个场景作为应用程序的主屏幕 -- Layout --- Adjust Scroll View Insets --- Hide Bottom Bar on Push 推出新的视图时隐藏底部控制条 --- Resize View From Nib --- Use Full Screen (Deprecated) -- Extend Edges --- Under Top Bars --- Under Bottom Bars --- Under Opaque Bars -- Transition Style 设置页面出现效果 --- Cover Vertical 向上推出 --- Flip Horizontal 水平翻转 --- Cross Dissoive 出现 --- Partial Curl 向上翻页 -- Presentation --- Full Screen --- Current Context --- Page Sheet --- Form Sheet --- Over Full Screen --- Over Current Context ---- Defines Context ---- Provides Context -- Content Size --- Use Preferred Explicit Size
-
-
3)View 设置
-
Attributes 设置面板
View . -- Mode -- Tag -- Interaction --- User Interaction Enabled 用户交互属性 --- Multiple Touch 多点触控 -- Alpha -- Background 背景颜色 -- Tint 前景颜色 -- Drawing --- Opaque --- Hidden 隐藏视图 --- Clears Graphics Context --- Clip Subviews 子视图范围不允许超过父视图 --- Autoresize Subviews 允许子视图随父视图缩放 -- Stretching
-
3、StoryBoard 关联
3.1 添加控件代码关联
打开 Assistant Editor 同时显示界面设计与代码,按住 Ctrl 键同时拖动控件到代码里,在弹出的上下文菜单中设置需要关联的类型,即可在代码里自动生成代码,这里主要有两种关联类型,一种是 Outlet 连接,就是在代码里创建界面元素的成员变量引用,另一种是 Action 事件,把界面元素的响应事件方法添加到代码里来。如果已经创建了代码,也可以把控件直接拖放到对应代码上,这时候就不是插入而是直接建立连接了。
1) IBAction:
从返回值角度上看,作用相当于 void,只有返回值声明为 IBAction 的方法,才能跟 storyboard 中的控件进行连线。2) IBOutlet:
只有声明为 IBOutlet 的属性,才能跟 storyboard 中的控件进行连线。-
3) 连线容易出现的问题:
如果遇到这种错误,90% 的可能都是因为连线有问题,比如一些线已经 “过期”。-
1> 连接的方法代码被删掉,但是连线没有去掉:
unrecognized selector sent to instance 0x7f9bf9610910libc++abi.dylib: terminating with uncaught exception of type NSException
-
2> 连接的属性代码被删掉,但是连线没有去掉:
'NSUnknownKeyException', reason: '[<ViewController 0x7fdf7048b200> setValue:forUndefinedKey:]: this class is not key value coding-compliant for the key
-
-
Objective-C
// Outlet 连接 @property (weak, nonatomic) IBOutlet UILabel *myLabel; // Action 事件 - (IBAction)buttonClick:(UIButton *)sender { }
-
Swift
// Outlet 连接 @IBOutlet weak var myLabel: UILabel! // Action 事件 @IBAction func buttonClick(sender: UIButton) { }
3.2 添加 segue 关联
右键(或 control + 鼠标左键)拖动控件到目标场景,在弹出的上下文菜单中选择 show 等。如果是两个 Controller 之间建立包含关联,则上下文之间会有 Relationship Segue 的选项,选择 view controller 即可。
-
segue 界面关联类型:
Relationship Segue 包含关联 show 导航推出,推出页自带返回按钮 show detail 详情推出 present modally 视图控制器之间跳转 popover presentation 视图控制器之间跳转返回 custom 自定义方式跳转 -
Objective-C
// 系统自带场景跳转相关方法,可以不写该方法 - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender { /* segue:场景里跳转的线 sender:触发跳转的对象 */ // 获取目标视图控制器 UIViewController *viewController = segue.destinationViewController; viewController.view.backgroundColor = [UIColor orangeColor]; }
-
Swift
// 系统自带场景跳转相关方法,可以不写该方法 override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject?) { /* segue:场景里跳转的线 sender:触发跳转的对象 */ // 获取目标视图控制器 let viewController = segue.destinationViewController viewController.view.backgroundColor = UIColor.purpleColor() }
4、StoryBoard 场景跳转
1)创建 按钮 与 Controller 间 segue 关联,无需添加代码,直接点击按钮即可实现页面跳转。
-
2)创建 Controller 与 Controller 间 segue 关联,并设置 segue 的 Identifier 值,在按钮点击响应事件中添加页面跳转代码。
-
Objective-C
// 根据 segue Identifier 跳转界面 [self performSegueWithIdentifier:@"segueIdentifier" sender:self];
-
Swift
// 根据 segue Identifier 跳转界面 self.performSegueWithIdentifier("segueIdentifier", sender: self)
-
-
3)设置要跳转到的 Controller 的 StoryBoard ID,在按钮点击响应事件中添加页面跳转代码。
Name:StoryBoard 文件名称,Identifier:ViewController 中设置的 StoryBoard ID 名称
-
Objective-C
UIViewController *secondViewController = [[UIStoryboard storyboardWithName:@"Main" bundle:nil] instantiateViewControllerWithIdentifier:@"storyboardID"]; UIViewController *secondViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"storyboardID"]; [self presentViewController:secondViewController animated:YES completion:nil];
-
Swift
let secondViewController = UIStoryboard(name: "Main", bundle: nil).instantiateViewControllerWithIdentifier("storyboardID") let secondViewController = self.storyboard!.instantiateViewControllerWithIdentifier("storyboardID") self.presentViewController(secondViewController, animated: true, completion: nil)
-
4)不同 StoryBoard 文件中,设置要跳转到的 Controller 的 Is Initial View Controller 或者 StoryBoard ID,在按钮点击响应事件中添加页面跳转代码。
若 StoryBoard 中设置了 Is Initial View Controller 可以直接使用 instantiateInitialViewController 初始化,若 StoryBoard 中没有设置 Is Initial View Controller 必须使用 instantiateViewControllerWithIdentifier 初始化。
-
Objective-C
UIViewController *secondStoryBoardVC = [[UIStoryboard storyboardWithName:@"secondStoryBoard" bundle:nil] instantiateInitialViewController]; UIViewController *secondStoryBoardVC = [[UIStoryboard storyboardWithName:@"secondStoryBoard" bundle:nil] instantiateViewControllerWithIdentifier:@"secondStoryBoard"]; [self presentViewController:secondStoryBoardVC animated:YES completion:nil];
-
Swift
let secondStoryBoardVC = UIStoryboard(name: "secondStoryBoard", bundle: nil).instantiateInitialViewController()! let secondStoryBoardVC = UIStoryboard(name: "secondStoryBoard", bundle: nil).instantiateViewControllerWithIdentifier("secondStoryboardID") self.presentViewController(secondStoryBoardVC, animated: true, completion: nil)
5、StoryBoard 页面传值
-
1)Segue 传值 - 正反传值
-
Objective-C
// 系统自带场景跳转相关方法 - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender { // 1、发送方,获取输入框中的数据 NSString *msg = _sendTextField.text; UIViewController *vc = segue.destinationViewController; // 2、发送方,发送数据,Key 与接收方设置的接收变量需一致 [vc setValue:msg forKey:@"passData"]; } // 3、接收方,声明接受数据变量,需与发送方设置的 Key 一致 @property(nonatomic, retain)NSString *passData; // 4、接收方,接收数据 _receiveLabel.text = _passData;
-
Swift
// 系统自带场景跳转相关方法 override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject?) { // 1、发送方,获取输入框中的数据 let msg = sendTextField.text let vc = segue.destinationViewController // 2、发送方,发送数据,Key 与接收方设置的接收变量需一致 vc.setValue(msg, forKey: "passData") } // 3、接收方,声明接受数据变量,需与发送方设置的 Key 一致 var passData:String? // 4、接收方,接收数据 receiveLabel.text = passData
-
2)复合传值
- 3)单例传值
4)userDefaults 传值
- 5)代理传值
6)Block/闭包 传值