在 iOS 7 上遇到「自訂了 leftBarButtonItem 之後,右滑返回手勢就失效」是很典型的問題。本文整理原因與兩種解法,並補上如何攔截手勢返回的按壓事件。
iOS 7 之前,若想自訂返回按鈕,直接設定 backBarButtonItem 並無法完全控制外觀。常見有兩條路:
第一條,用 leftBarButtonItem 直接取代系統返回鍵。
第二條,透過 UIBarButtonItem 的 appearance 全域替換返回鍵的背景與文字位置:
UIImage *backImage = [[UIImage imageNamed:@"navigation_back_button.png"]
resizableImageWithCapInsets:UIEdgeInsetsZero];
[[UIBarButtonItem appearance] setBackButtonBackgroundImage:backImage
forState:UIControlStateNormal barMetrics:UIBarMetricsDefault];
[[UIBarButtonItem appearance] setBackButtonTitlePositionAdjustment:
UIOffsetMake(0, backImage.size.height * 2) forBarMetrics:UIBarMetricsDefault];
但第二種方式只能改背景與文字位置,無法自訂返回箭頭圖示本身。因此若要完全掌控外觀,leftBarButtonItem 仍是最佳選擇。
iOS 7 新增了「右滑返回上一頁」的系統手勢,由 UINavigationController 的 interactivePopGestureRecognizer 負責。當你改用 leftBarButtonItem 時,導航控制器會認為堆疊中的返回項不完整,於是這個手勢被停用。
[_currentNav pushViewController:viewController animated:YES];
// 開啟 iOS 7 的滑動返回效果
if ([_currentNav respondsToSelector:@selector(interactivePopGestureRecognizer)]) {
_currentNav.interactivePopGestureRecognizer.delegate = nil;
}
把 delegate 設為 nil,等於解除導航控制器對手勢的限制條件,滑動返回立刻恢復可用。改動只有三行,且不需侵入每個 view controller。
self.navigationItem.backBarButtonItem = backButton; self.navigationController.interactivePopGestureRecognizer.delegate = self;
這種寫法必須放在 viewWillAppear: 中才有效,且每個頁面都要寫一次,改動量明顯較大。此外 delegate 設為 self 之後,你必須自行實作 gestureRecognizerShouldBegin: 並在適當條件下回傳 YES,否則手勢同樣不會啟動。綜合來看,優先採用解法一。
啟用手勢之後還會發現另一個問題:右滑返回不會呼叫你設在 leftBarButtonItem 上的 action。若返回時需要做一些清理(例如停止播放、儲存草稿),可用 viewWillDisappear 判斷自己是否已被移出導航堆疊:
- (void)viewWillDisappear:(BOOL)animated {
[super viewWillDisappear:animated];
if (![[self.navigationController viewControllers] containsObject:self]) {
// 已從導航堆疊移除,通常代表發生了返回
}
}
這個判斷同時涵蓋了「點左鍵返回」與「滑動返回」兩種路徑,因此不必再分別處理。需要注意的是,當導航堆疊很長時 containsObject: 的線性搜尋會有輕微成本,若堆疊層級極深可改用比較 viewControllers.count 或記錄自身在堆疊中的索引來優化。
如果你不需要自訂返回箭頭,iOS 7 之後可以直接用 UIBarButtonItem appearance 的 setBackButtonBackgroundImage:forState:barMetrics: 換箭頭圖,再搭配 backBarButtonItem 設定文字,這樣滑動返回天然可用,是最省事的方案。若專案已全面採用 iOS 15 的 UINavigationBarAppearance,也可在 appearance 物件上直接指定 backIndicatorImage,效果相同。