用 Storyboard 建立 UICollectionViewController 時,會遇到一個容易踩空的問題:明明覆寫了 init,斷點卻永遠不進去。本文記錄這個現象的原因。
因為頁面是在 Storyboard 中建立的,layout 與 cell size 等屬性也都直接在 Storyboard 上設定。而 UICollectionViewController 本身有四個初始化方法:
- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil; - (id)initWithCollectionViewLayout:(UICollectionViewLayout *)layout; - (id)initWithCoder:(NSCoder *)aDecoder; - (id)init;
但由於控制器是從 Storyboard 反序列化產生的,實際上只有 initWithCoder: 會被呼叫,另外三個都不會。
Storyboards 與 xib 的運作方式是「把畫面序列化成檔案,執行時再解序列化還原」。解序列化一定走 NSCoding 的 initWithCoder:,而 initWithCollectionViewLayout: 是「用程式碼建立控制器」時才會用到的設計初始化器。兩條路徑互斥,所以覆寫錯方法就會完全沒有效果。
- (instancetype)initWithCoder:(NSCoder *)aDecoder {
self = [super initWithCoder:aDecoder];
if (self) {
// 在 Storyboard 場景中,這裡要做的額外初始化
}
return self;
}
若希望用程式碼指定自訂 layout,就不能依賴 Storyboard 建立控制器,而要改為:
MyLayout *layout = [[MyLayout alloc] init]; UICollectionViewController *vc = [[MyCollectionViewController alloc] initWithCollectionViewLayout:layout];
註冊自訂的區塊標題視圖:
[self.collectionView registerClass:[MCMonthHeaderView class]
forSupplementaryViewOfKind:UICollectionElementKindSectionHeader
withReuseIdentifier:@"monthHeader"];
MCMonthHeaderView 繼承自 UICollectionViewReusableView,它有三個初始化方法:
- (id)initWithFrame:(CGRect)frame; - (id)initWithCoder:(NSCoder *)aDecoder; - (id)init;
由於是以 registerClass(純程式碼、非 xib)的方式註冊,實際被呼叫的只有 initWithFrame:。若改用 registerNib:forSupplementaryViewOfKind:withReuseIdentifier:,則會改走 initWithCoder:——這一點在自問「為什麼我寫的 init 沒被執行」時特別容易搞混。
判斷方式很簡單:畫面是從檔案(Storyboard/xib)還原的,就走 initWithCoder;是程式碼 new 出來的,就走 initWithFrame 或指定的 init 方法。