Premiers pas avec le storyboard dans iOS 5 (3)

Présentation de Segues

Il est temps d'ajouter quelques ViewControllers supplémentaires à notre storyboard. Nous allons créer un scénario permettant à l'utilisateur d'ajouter de nouveaux joueurs au programme.

Faites glisser un BarButtonItem vers l'extrémité droite de la barre de navigation dans la scène Players. Changez son identifiant en Ajouter via le panneau des propriétés afin qu'il devienne un bouton standard. Lorsque vous cliquez sur ce bouton, une nouvelle fenêtre modale apparaîtra dans laquelle vous pourrez saisir les informations du nouveau joueur.

Faites glisser un TableViewController dans le canevas et placez-le sur le côté droit de la scène Players. Vous pouvez réduire la toile en double-cliquant afin d'avoir plus d'espace pour travailler.

Sélectionnez ce TableViewController et intégrez-le dans un navigationController (via le menu "EditorEmbedInNavigation Controller").

Ensuite, veuillez noter : sélectionnez le bouton, maintenez la touche Ctrl enfoncée et faites-le glisser vers le contrôleur de navigation nouvellement ajouté.

Lâchez la souris et sélectionnez Modal dans le menu contextuel. Il y aura une flèche supplémentaire entre la scène Players et NavigationController :

Cette connexion est appelée segue (prononcé : seg-way), ce qui signifie passer d'un ViewController à un autre. . Ceci est différent d'une relation utilisée pour indiquer qu'un ViewController contient un autre ViewController. En d’autres termes, une transition change tout à l’écran. Déclenché lorsqu'un bouton, un toucher ou un geste sur TableViewCell (et des choses similaires). Ce qui est bien avec

segue, c'est que vous n'avez pas besoin d'écrire de code pour afficher la nouvelle fenêtre. Il n'est pas nécessaire de connecter le bouton à l'IBAction. Comme nous venons de le faire, il suffit de glisser une ligne reliant le barButtonItem à la scène suivante. (Si le contrôle dispose déjà d'une connexion IBAction, la séquence l'écrasera).

Exécutez le programme et appuyez sur le bouton. Un nouveau TableView apparaîtra !

Il s'agit d'une transition « modale ». La nouvelle fenêtre recouvre complètement la fenêtre avant. L'utilisateur ne peut pas interagir avec la fenêtre précédente à moins que la fenêtre contextuelle ne soit fermée. Nous ferons ensuite la démonstration d'une séquence "push", qui pousse une nouvelle fenêtre sur la pile du contrôleur de navigation.

Ce nouveau ViewController n'est pas très utile - vous ne pouvez même pas le fermer et revenir à la fenêtre principale !

La transition n'est qu'à sens unique, de la fenêtre Joueurs vers la nouvelle fenêtre. Pour revenir, vous devez utiliser le modèle de délégué. Tout d'abord, nous devons créer une classe pour la nouvelle scène. Ajoutez une sous-classe UITableViewController au projet et nommez-la PlayerDetailsViewController.

Retournez à l'éditeur de storyboard, sélectionnez le nouveau TableViewController et remplacez Class par PlayerDetailsViewController dans le panneau Identité. J'oublie souvent cette étape, je vous rappelle donc de ne pas faire la même chose que moi.

Changez son titre en « Ajouter un joueur » (en double-cliquant sur la barre de navigation). Ajoutez également deux éléments BarButton à la barre de navigation. Dans le panneau Propriétés, définissez l'identifiant du bouton gauche sur Annuler et l'identifiant du bouton droit sur Terminé.

Puis modifiez PlayerDetailsViewController.h :

@class PlayerDetailsViewController;  
@protocol PlayerDetailsViewControllerDelegate <NSObject>
- ( void ) playerDetailsViewControllerDidCancel :    ( PlayerDetailsViewController *) controller;
- ( void ) playerDetailsViewControllerDidSave :    ( PlayerDetailsViewController *) controller;
@end  
 
@interface PlayerDetailsViewController : UITableViewController  
@property ( nonatomic, weak ) id <PlayerDetailsViewControllerDelegate> delegate;  
- ( IBAction ) cancel :( id ) sender;
- ( IBAction ) done :( id ) sender;  
@end

Nous définissons un protocole délégué afin que lorsque l'utilisateur clique sur Annuler ou Terminé, nous puissions revenir de la fenêtre AddPlayer à la fenêtre Players.

Retournez à l'éditeur de storyboard et connectez le bouton Annuler et le bouton Terminé aux méthodes d'action correspondantes. La première méthode consiste à maintenir la touche ctrl enfoncée, à faire glisser de BarButtonItem vers ViewController, puis à sélectionner la méthode d'action appropriée dans le menu contextuel :

Dans PlayerDetailsViewController.m , Ajoutez ces deux méthodes :

- ( IBAction ) cancel :( id ) sender {
        [ self.delegate playerDetailsViewControllerDidCancel : self ] ;
} - ( IBAction ) done :( id ) sender {
        [ self.delegate playerDetailsViewControllerDidSave : self ] ;
}

Ces deux méthodes correspondent respectivement à deux BarButtons. Ces méthodes informent l'objet délégué des événements qui ont été déclenchés. En fin de compte, vous devez demander à l'objet délégué de fermer la fenêtre (ce n'est pas obligatoire, mais j'aime ça. Bien sûr, vous pouvez également laisser AddPlayer se fermer avant ou après avoir notifié l'objet délégué).

Notez que les méthodes déléguées placent généralement une référence à l'appelant comme premier paramètre (ou seul paramètre) de la méthode. Il s'agit du paramètre PlayerDetailsViewController. Cela permet à l'objet délégué de savoir quel objet lui a envoyé le message.

N'oubliez pas de synthétiser l'attribut délégué :

@synthesize délégué;

Nous avons déjà le PlayerDetailsViewController. Un protocole de délégation est défini et nous devons l'implémenter quelque part. Évidemment, cet endroit devrait être PlayersViewController. Parce qu'il est responsable du rendu de la fenêtre AddPlayer. Ajoutez le code suivant à PlayerViewController.h :

#import "PlayerDetailsViewController.h"  
@interface PlayersViewController : UITableViewController <PlayerDetailsViewControllerDelegate>

Ajoutez le code suivant à la fin de la méthode PlayersViewController.m :

#pragma mark - PlayerDetailsViewControllerDelegate  
- ( void ) playerDetailsViewControllerDidCancel :    ( PlayerDetailsViewController *) controller {
        [ self dismissViewControllerAnimated : YES completion : nil ] ;
}  
- ( void ) playerDetailsViewControllerDidSave :    ( PlayerDetailsViewController *) controller {
        [ self dismissViewControllerAnimated : YES completion : nil ] ;
}

   

这里只是简单地关闭 AddPlayer 窗口。稍后我们会做一些有趣的事情。

iOS5 中出现了新的dismissViewControllerAnimated:completion: 方法。你也可以用之前的老  dismissModalViewControllerAnimated: 方法。但新方法将更加优雅地关闭ViewController（它能给你一个机会在窗口被关闭后能执行额外的代码）。

剩下只有一件事情： Players 窗口需要告诉 PlayerDetailsViewController它将成为它的委托。你可能想，用故事版编辑器在二者间拖一条线不就完了吗？很不幸，这不行。在 segue 中，为了传递数据到下一个 ViewController ，我们仍然必须编写代码。

在PlayersViewController 中添加如下方法：

- ( void ) prepareForSegue :( UIStoryboardSegue *) segue sender :( id ) sender {
        if ([ segue.identifier isEqualToString : @ "AddPlayer" ]) {
               UINavigationController * navigationController =             segue.destinationViewController;
               PlayerDetailsViewController * playerDetailsViewController = [[ navigationController viewControllers ] objectAtIndex : 0 ] ;
               playerDetailsViewController.delegate = self;
        }
}

   

prepareForSegue 方法在即将发生 segue 之时触发。新的 ViewController 已经同故事版一起加载了，但它是不可见的，我们必须利用这个方法传递参数给它。（永远不要自己调用prepareForSegue 方法，它由 UIKit 调用以通知你正在触发一个 segue。）

注意 segue 的目标将是 NavigationController，它与我们的BarButtonItem 是关联的。为了得到 PlayerDetailsViewController实例，我们必须从 NavigationController 的 viewControllers 属性中将它找出来。

运行程序，按下 + 号按钮，尝试关闭 AddPlayer 窗口。居然没有效果！

那是因为我们并没有指定 segue 的 identifier 。而在prepareForSegue  方法中我们检查了 identifier 是否为 AddPlayer。在同一个 ViewController 中存在多个 segue 的情况下，建议你通过 identifier 来区分不同的 segue。

在故事版编辑器中，选择该 segue，注意 BarButtonItem 会被加亮显示以便你能清楚地知道是哪个控件触发这个segue。

在属性面板中，将 identifier 设为 AddPlayer。

再次运行程序，触摸 Cancel 或 Done 按钮，现在都能关闭窗口并返回玩家列表了。

 

注意：也可以从模式窗口中调用 dismissViewControllerAnimated:completion:方法。不一定非要让代理对象来关闭。但如果你这样做，要留意一件事情：你原来使用的[self.parentViewController dismissModalViewControllerAnimated:YES] 不再有效。可以用 self.presentingViewController 替换 self.parentViewController，但这是在 iOS5 之后出现的新属性。

另外，在 segue 的属性面板中，有一个 Transition 字段，在此你可以选择不同的过渡动画。

你净可以尝试你最喜欢的设置。但不要改变 Style 属性。对于这个窗口，它只能是Modal——任何其他选项都会导致程序崩溃！

在本教程中，我们多次使用委托模式。在此我们列出了在两个场景中建立连接的步骤：

从源场景的按钮或其他控件创建 segue 到另一个场景。（如果你想呈现一个模式窗口，通常目标对象应该是一个 NavigationController)。

指定 segue 的 identifier。（对于同一源场景，identifier必须是唯一的;不同的源场景则可以有重复）。

为目标场景创建委托协议。

从 Cancel 按钮和 Done 按钮中调用委托方法，对于目标场景想回到源场景的任何地方，你都要这样做。

在源场景中实现委托协议。当 Cancel 按钮或 Done 按钮被触摸时，委托对象应当负责关闭目标 ViewController。

 在源 ViewController 中实现 prepareForSegue 方法，并让目标场景的 delegate=self;

委托模式是必然的，因为没有“反向 segue”这样的东西。当 segue 被触发，它创建的都是新的目标ViewController 实例。你当然可以创建一个 segue 用于从目标返回到源场景，但这太想当然了。

打比方，你可以从 Cancel 按钮创建一个 segue 返回Players 窗口，但却无法关闭 Add Player 窗口回到 Players。除非你创建一个新的 Players 对象。这样你就创建了一个无尽循环直到耗净所有内存。

记住：Segue 只有一个方向，只能用于打开新窗口。要关闭它返回（或者将他从NavigationController 栈中弹出），通常使用委托模式。segue 只适用于源场景，目标 ViewController 根本不知道 segue是什么玩意。

 

静态Cell

最终的 Add Player 窗口如下图所示：

这是一个分组表视图，但这次我们不需要为它创建一个数据源。我们可以直接在故事版编辑器中设计它，不需要写cellForRowAtIndexPath 方法。这种新特性叫做静态cell。

在 Add Players 场景中选择 tableView，在属性面板修改Content 为 Static Cells。Style 则选择 Grouped，Sections 设置为 2。

Sections 属性一旦改变，编辑器将克隆已有的 section。（你也可以从左边的文档树中选择某个 section 然后复制它）。

对于每个 section，我们只有一行。选择多余的行并删除。选择最上面的section ，通过属性面板，在 Header 字段中输入 Player Name。

拖一个新的 TextField 到这个 section 的仅有的 cell中。移除它的边框，这样你就看不到 textfield 的头和尾。设置字体为 System 17 ，反选Adjust to Fit。

我们将使用 Assistan Editor 创建 textField 的IBOutlet。打开 Assistant Editor，它将自动打开 PlayerDetailsViewController.h。选中 TextField 然后按住 ctrl 拖到 .h 文件中：

放开鼠标键，将弹出窗口：

Name 设置为 nameTextField。点击 Connect，Xcode 将在PlayerDetailsViewController.h 中添加如下属性：

@property ( strong, nonatomic ) IBOutlet UITextField * nameTextField;

   

同时它也自动合成了属性，并在 viewDidUnload 方法中加入语句。

我说过这种方法不能在模板cell 上使用，但在静态 cell 中是可以的。每个静态cell 只有一个实例（与模板 cell 不同，它们不会被复制），因此将它们的 subview 与 ViewController的出口连接是完全可行的。

设置第二个section 的静态 cell 的 Style 为 RightDetail。这是一种标准的 cell 样式。将左边的 Label 文本设置为 Game，accessory 设置为 disclosure indicator。为右边的Label 创建一个出口，命名为 detailLabel。这两个 Label 都是通常的 UILabel 对象。

设计后的 Add Player  窗口最终如下图所示:

使用静态 cell 时，TableViewController 不用数据源。因为PlayerDetailsViewController  类是 Xcode 模板创建的，代码中会存在数据源的模板代码，我们需要删除它。删除在：

#pragma mark - Table view data source

   

和：

#pragma mark - Table view delegate

   

之间的所有行。这将消除 Xcode 在添加这个类时的一些警告。运行程序，查看静态cell 的效果。我们没有写一行代码——实际上反倒删除了一大堆的代码。

但我们免不了还是要写一些代码。在你想第一个单元格加入 textField 时，你可能会注意到它稍有些不妥，在它的周围会有一些多余的空间。用户看不见textField 的头和尾，因此当他们触摸到这些空处的时候，键盘不会弹出。这个很容易解决，覆盖tableView:didSelectRowAtIndexPath 方法代码如下所示:

- ( void ) tableView :( UITableView *) tableView    didSelectRowAtIndexPath :( NSIndexPath *) indexPath {
        if ( indexPath.section == 0 )
               [ self.nameTextField becomeFirstResponder ] ;
}

   

即用户触摸到第一个单元格时，我们激活 textField 焦点（在这个section 中只有一个 cell，因此我们只需要检查 section 的索引即可）。这将自动弹出软键盘。这只是微不足道的工作，但能降低用户的不满。

你还应该在属性面板中将 cell 的 selection style 设置为None，否则用户触摸在文本框附近时，整个行将变成蓝色。

好了，这就是 AddPlayer 窗口的设计了。现在我们要让它真正发挥作用。

以上就是iOS 5 故事板入门（3）的内容，更多相关内容请关注PHP中文网（www.php.cn）！