WatchKit编程指南：WatchKit Apps--表格

本文翻译自Apple Watch Programming Guide：WatchKit Apps--Tables，敬请勘误。
使用table展示内容可动态更改的列表数据。WatchKit 仅支持使用WKInterfaceTable类的单列表格。想要在table中展示数据，需要先为数据定义布局，并在运行时通过编码填写表数据。您需要在Xcode工程中做以下事情：
在storyboard文件中：
给界面控制器场景添加table对象，并在界面控制器中为table创建一个outlet。
像Configuring Row Types描述的那样为table配置一个或多个row types。
在代码中:
为依照Configuring Row Types定义的row type定义一个row controller 类。
在初始化阶段，依照Configuring the Table's Contents at Runtime向table中添加行
按照Handling Row Selections所述响应用户与表格行的交互。
您可以为每个table定义多个行类型，每种类型都有不同的外观。在运行时，您可以指定所需行类型以及它们在table中的排列顺序。对于如何配置table的详细信息，请参看WKInterfaceTable Class Reference.
配置Row Types
Row Type是一个在table中以单行形式展示数据的模板。每个table必须至少有一个row type，您可以根据需求定义额外的row type。您可以用row type区分table中的不同内容。比如您可能在内容行上、标题和注脚上使用不同的类型。当您为界面控制器场景添加table时，Xcode会自动创建初始的row types供您配置。
为table添加row types：
在storyboard文件中选中table对象
打开Attributes inspector.
使用Rows属性更改可用row type数量。
每个row type最初都包含一个单个组元素。您可以为该组元素添加标签、图片以及其他所需对象。标签和图片的真实内容通常是无关紧要的。在运行时，作为配置工作的一部分，您可以替换界面对象的内容。
想要在运行时管理表格行的内容，您需要提供一个自定义的row controller 类。大部分row controller类包含少量代码，或者根本就不包含代码，它们主要用来访问那些包含界面对象的outlets。不过，如果您在表格行中添加了按钮或者其他控件，那么其类也会包含一些动作方法，以响应用户与控件的交互。
为row type定义一个row controller类：
为WatchKit扩展添加一个新的Cocoa Touch类
让新类继承NSObject。
为每个计划在运行时访问的标签、图片或者控件添加声明的属性。声明属性可使用以下格式，请更改类以匹配相应的界面对象：

@property (weak, nonatomic) IBOutlet WKInterfaceLabel* label;

Listing 10-1 展示了一个用于管理row type的示例类

@interface MainRowType : NSObject
@property (weak, nonatomic) IBOutlet WKInterfaceLabel* rowDescription;
@property (weak, nonatomic) IBOutlet WKInterfaceImage* rowIcon;
@end

您可以在storyboard文件中完成row type配置。配置表格行要求设置其类，并将任何outlets连接到对应的界面对象上。您还必须提供一个方法，以便通过命名row type在运行时辨别表格行。
在storyboard中配置row type：
在storyboard文件中选中row controller对象。
将row controller的Identifier属性设置为唯一值，随后您会在创建表格行时使用该标识符。
在行类型中该值必须是唯一的，但是实际值还是由您来定夺。在Attributes inspector中设置该值。
将row type的类设置为您的自定义类。您需要在Identity inspector中设置类信息。
将row type元素和类中对应的outlets连接起来。
将storyboard文件中的项目和outlets连接并绑定。当您在代码中配置table时，WatchKit会在运行时使用该信息实例化对应的类。
Figure 10-1 在Xcode中配置一个命名为"Main Row Type"的row type，并设置为使用Listing 10-1中定义的MainRowType类。该类中的rowDescription 和rowIcon outlets被连接到行中的图片和标签。


运行时配置table内容
在运行时，您可以为table添加表格行并以编程形式配置其内容。通常，添加并配置表格行是初始化界面控制器过程中的一部分。
创建并配置列表行
先决定你需要创建的行的数目和类型，这取决于你想要展示的数据类型。
使用setRowTypes:或者setNumberOfRaws:withRowType:方法来创建。这两个方法都会在界面上创建新的列表行，并且会在WatchKit扩展中实例化对应的类。这些实例被保存在table中，且可通过rowControllerAtIndex:方法访问。
使用rowControllerAtIndex:方法遍历表格中的每一行。
使用row controller对象来配置每一行中的内容。
setRowType:和setNumberOfRaws:withRowType:方法实例化与storyboard文件中对应的行类型相关的类。在调用这些方法之后，紧接着就可以直接获取最新创建的row controller对象了，当然还可以通过这些对象来设置内容。下面的Listing 10-2这段代码则是一个能创建新行并对其进行配置的简单示例。在这个例子里，使用的是在代码Listing 10-1中定义的MainRowType类，以及自定义的MyDataObject类，MyDataObject类用于提供table中用于行内容的数据。在setNumberOfRaws:withRowType:方法中设置好数据对象之后，代码会遍历该对象，并使用它们配置表格中每一行的内容。
Listing 10-2 创建并配置table中的行

- (void)configureTableWithData:(NSArray*)dataObjects {
    [self.table setNumberOfRows:[dataObjects count] withRowType:@"mainRowType"];
    for (NSInteger i = 0; i < self.table.numberOfRows; i++) {
        MainRowType* theRow = [self.table rowControllerAtIndex:i];
        MyDataObject* dataObj = [dataObjects objectAtIndex:i];
 
        [theRow.rowDescription setText:dataObj.text];
        [theRow.rowIcon setImage:dataObj.image];
    }
}

表格行的选中处理
界面控制器负责处理table中的行选中操作。当用户点击table中的某一行，WatchKit会选中该行并调用WatchKit扩展中正确的方法。您可以在以下地方处理表格行的选中操作：
界面控制器的table:disSelectRowAtIndex:方法中。
界面控制器自定义的动作方法中。
您可以使用以上两者之一来处理行选中事件。如果您的界面控制器有多个table，那推荐使用一个动作方法，因为您无需判定操作跟哪个table有关。如果您使用了一个动作方法，那需要遵循下面的语法：

- (IBAction)myTableAction:(NSInteger)rowIndex

通过选中表格行来执行app相关的任何操作，比如跳转新界面，或者更新行中显示的内容。如果您不希望用户选中表格行，可以在Storyboard中禁用相应的row controller的Selectable选项。