
在 Interface Builder 與程式碼之間建立連接時,我們最常使用 IBOutlet 與 IBAction。常用 xib 或 storyboard 的人對這兩個關鍵字應該很熟了。不過 UIKit 還提供了另一個「偽關鍵字」IBOutletCollection,它能讓你把介面上同一類的一組控件連到同一個陣列裡。
這個偽關鍵字可以在 UIKit.framework 的 UINibDeclarations.h 中找到:
#ifndef IBOutletCollection\n#define IBOutletCollection(ClassName)\n#endif
而在 Clang 源碼中,有更嚴謹的定義方式:
#define IBOutletCollection(ClassName) __attribute__((iboutletcollection(ClassName)))
從定義不難看出,與 IBOutlet 不同,IBOutletCollection 帶有一個參數,也就是類名。
通常宣告 IBOutletCollection 屬性時,屬性必須是 strong,型別則是 NSArray:
@property (strong, nonatomic) IBOutletCollection(UIScrollView) NSArray *scrollViews;
假設 xib 裡有三個橫向的 scrollView,我們可以把這三個都連到 scrollViews 屬性,然後在程式碼中做統一處理:
- (void)setupScrollViewImages {\n for (UIScrollView *scrollView in self.scrollViews) {\n [self.imagesData enumerateObjectsUsingBlock:^(NSString *imageName, NSUInteger idx, BOOL *stop) {\n UIImageView *imageView = [[UIImageView alloc] initWithFrame:CGRectMake(CGRectGetWidth(scrollView.frame) * idx, 0, CGRectGetWidth(scrollView.frame), CGRectGetHeight(scrollView.frame))];\n imageView.contentMode = UIViewContentModeScaleAspectFill;\n imageView.image = [UIImage imageNamed:imageName];\n [scrollView addSubview:imageView];\n }];\n }\n}這段程式碼會一次作用到三個 scrollView,好處是不必手動呼叫 addObject: 把元素塞進陣列。
集合中物件的順序是不確定的。用除錯工具觀察時,順序看起來與連接順序一致,但這個順序可能隨 Xcode 版本而不同,因此不該在程式碼中依賴它。
屬性型別永遠是 NSArray。無論 IBOutletCollection(ClassName) 中寫的是什麼控件,屬性實際上都指向一個 NSArray。也就是說,即使你宣告成 NSSet、NSMutableArray,甚至 UIColor,IB 連接後它依然是一個 NSArray。
針對第二點,我們把上面的 scrollViews 改成:
@property (strong, nonatomic) IBOutletCollection(UIScrollView) NSSet *scrollViews;
在控制台列印時會看到:
(lldb) po self.scrollViews\n(,<UIScrollView: ...>,)
可以看到它指向的仍是一個 NSArray。
另外,IBOutletCollection 其實在 iOS 4 就有了。只不過現在 Objective-C 已支援 object literals,宣告陣列可以直接寫 @[],方便許多;而且這種方式還能加入不在 xib 中、以程式碼建立的檢視,靈活度更高。究竟選哪一種,就看你自己的實際需求與偏好。
IBAction / IBOutlet / IBOutletCollection
IBOutletCollection.m