iOS - UIStoryboard

前言

	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 中的控件进行连线。
• 1. IBOutlet：
     
     只有声明为 IBOutlet 的属性，才能跟 storyboard 中的控件进行连线。
• 1. 连线容易出现的问题：
     
     如果遇到这种错误，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/闭包 传值