iOS學習—— UINavigationController的返回按鈕與側滑返回手勢的研究
側滑返回手勢是從iOS7開始增加的一個返回操作,經歷了兩年時間估計iPhone使用者大部分都已經忽略了螢幕左上角那個礙眼的back按鈕了。之前在網上搜過有關側滑手勢的技術部落格,發現大多比較散亂,甚至有很多都是簡單的貼上複製,並不全面。側滑返回的操作效果與左上角的back按鈕是一樣的,所以一起放在這裡進行探討。
導航欄左上角的back按鈕是附著在UINavigationController的UINavigationBar裡自帶的一個返回按鈕,導航欄自帶的back按鈕的圖層結構如下圖所示。一個UINavigationController只會有一個UIBackButtonContentView,但是可以有多個leftBarButtonItem、rightBarButtonItem(leftBarButtonItem、rightBarButtonItem就在下圖所示的UIButtonBarStackView圖層下),其中backButton與leftBarButtonItem之間的關係和區別在後面我們會講到。
一 側滑返回
側滑返回是系統iOS7自帶的一種方便使用者進行返回操作而推出的一種新功能。在開發過程中,對側滑返回進行控制非常簡單,主要就是啟動側滑手勢和禁用側滑手勢。首先,我們來看一下 UINavigationController
的 @property
,可以找到下面這個屬性。
@property(nullable, nonatomic, readonly) UIGestureRecognizer *interactivePopGestureRecognizer;
1.1 側滑開啟與關閉
UINavigationController的interactivePopGestureRecognizer這個屬性就是我們的側滑返回手勢,如果你的專案中沒有需求要自定義返回按鈕(雖然我覺得這並不太可能),那麼你所需要的操作就非常簡單了,不多說直接上程式碼。
self.navigationController.interactivePopGestureRecognizer.enabled = YES; //啟用側滑手勢
self.navigationController.interactivePopGestureRecognizer.enabled = NO; //禁用側滑手勢
1.2 側滑使用注意
側滑手勢在使用中需要注意的一點就是在專案開發中,我們一般是採用的UITabBar + UINavigationController架構,對於每一個UITabBar的item模組,我們都定義一個UINavigationController對該item模組上的viewController進行控制。而在這個模組上,我們有某個或某些viewController需要禁用側滑手勢(一般需要禁用側滑手勢是因為返回或退出當前viewController時需要double confirm,在一些填表的頁面比較常見),而其他的viewController則不需要禁用側滑手勢。這時候我們就需要特別小心,因為 self.navigationController.interactivePopGestureRecognizer.enabled = NO; //禁用側滑手勢 是對當前的UINavigationController有效的,所以一旦你在某個介面禁用了側滑,那麼該UINavigationController控制下的所有viewController都會禁用側滑,這顯然是不合理的。提供一個解決方案就是在進入viewController時 - (void)viewDidAppear:(BOOL)animated; 中禁用側滑手勢,然後在離開viewController時 - (void)viewWillDisappear:(BOOL)animated; 開啟策劃手勢。具體程式碼如下:
- (void)viewDidAppear:(BOOL)animated
{
[super viewDidAppear:animated];
// 禁用返回手勢
if ([self.navigationController respondsToSelector:@selector(interactivePopGestureRecognizer)]) {
self.navigationController.interactivePopGestureRecognizer.enabled = NO;
}
}
- (void)viewWillDisappear:(BOOL)animated
{
[super viewWillDisappear:animated];
// 開啟返回手勢
if ([self.navigationController respondsToSelector:@selector(interactivePopGestureRecognizer)]) {
self.navigationController.interactivePopGestureRecognizer.enabled = YES;
}
}
1.3 側滑手勢的獲取
如果一個頁面上有多個手勢,我們要如何去獲取策劃手勢,並對其進行操作呢?其實很簡單,側滑手勢是一種UIScreenEdgePanGestureRecognizer,所以我們只需要對當前手勢的類別進行判斷就可以了。具體程式碼如下:
//獲取側滑返回手勢
- (UIScreenEdgePanGestureRecognizer *)screenEdgePanGestureRecognizer
{
UIScreenEdgePanGestureRecognizer *screenEdgePanGestureRecognizer = nil;
if (self.view.gestureRecognizers.count > 0)
{
for (UIGestureRecognizer *recognizer in self.view.gestureRecognizers)
{
if ([recognizer isKindOfClass:[UIScreenEdgePanGestureRecognizer class]])
{
screenEdgePanGestureRecognizer = (UIScreenEdgePanGestureRecognizer *)recognizer;
break;
}
}
}
return screenEdgePanGestureRecognizer;
}
1.4 UIScrollView與側滑手勢共存問題
UIScrollView及其子類自帶滑動手勢,所以如果一個viewController鐘有UIScrollView及其子類的view時,側滑手勢影響使用者體驗效果,此時使用者將無法通過側滑進行返回。因為側滑返回手勢事實上是由存在已久的UIPanGestureRecognizer來識別並響應的,它直接與UINavigationController的view進行繫結,因此在包含UIScrollView的viewController中存在如下關係:
UIPanGestureRecognizer ——bind—— UIScrollView
UIScreenEdgePanGestureRecognizer ——bind—— UINavigationController.view
滑動返回無法觸發,說明UIScreenEdgePanGestureRecognizer並沒有接收到手勢事件,也就是說UIScreenEdgePanGestureRecognizer被UIPanGestureRecognizer遮蔽了。因此,我們為了實現側滑返回手勢,我們需要設定兩種手勢的共存和先後響應問題,我們可以設定UIScrollView的UIPanGestureRecognizer手勢在UIScreenEdgePanGestureRecognizer失效時才識別,具體設定方法如下:
//指定滑動手勢在側滑返回手勢失效後響應
[self.tableView.panGestureRecognizer requireGestureRecognizerToFail:[self.navigationController screenEdgePanGestureRecognizer]];
二 導航欄的back按鈕
在瞭解導航欄的返回按鈕之前,我們先了解一下導航欄管理導航欄上各類控制元件的UINavigationBar。首先,我們先來看一看官方文件怎麼介紹UINavigationBar,A UINavigationBar
object is a bar, typically displayed at the top of the window, containing buttons for navigating within a hierarchy of screens. The primary components are a left (back) button, a center title, and an optional right button. You can use a navigation bar as a standalone object or in conjunction with a navigation controller object.組成如下圖左邊所示。最重要的一部分我用藍色加粗標出來了,就是說這個UINavigationBar主要是由左右按鈕控制元件、中間標題控制元件組成。原生的導航條上的返回(back)按鈕,一般是顯示一個返回箭頭+上一頁面的標題(或者是 返回箭頭+Back),如下圖右邊所示。
2.1 導航條上的按鈕三兄弟
在前面我們也提到了,在導航欄上有左右按鈕和返回按鈕,官方稱謂是backBarButtonItem、leftBarButtonItem、rightBarButtonItem。他們都屬於UINavigationItem的組成部分,都顯示在navigationBar上,都屬於UIBarButtonItem類,所以我給他們取名為導航條上的按鈕三兄弟,哈哈哈。。。
首先,我們來說一下leftBarButtonItem、rightBarButtonItem,這兩個是孿生兄弟,唯一的區別就是在導航條上的位置,顧名思義,leftBarButtonItem在導航條左側,rightBarButtonItem在導航條右側。此外,還有一點需要我們注意的是navigationBar上的leftBarButtonItem、rightBarButtonItem可以有多個,用法也非常簡單,常見用法就是一般在 - (void)viewDidLoad 中新增按鈕,然後新增按鈕的點選功能即可。
//新增取消btn
UIBarButtonItem *cancelBtn = [[UIBarButtonItem alloc] initWithTitle:@"取消" style:UIBarButtonItemStylePlain target:self action:@selector(navBtnPress:)] ;
cancelBtn.tag = 1000 ;
self.navigationItem.leftBarButtonItem = cancelBtn ;
//新增完成btn
UIBarButtonItem *createBtn = [[UIBarButtonItem alloc] initWithTitle:@"完成" style:UIBarButtonItemStylePlain target:self action:@selector(navBtnPress:)] ;
createBtn.enabled = NO ; //剛開始設定為不可選
createBtn.tag = 1001 ;
self.navigationItem.rightBarButtonItem = createBtn ;
/**
導航欄 取消 完成 按鈕的操作
@param sender <#sender description#>
*/
- (void) navBtnPress:(UIButton *)sender{
if (sender.tag == 1000) {
//取消
NSLog(@"cancel");
} else {
//完成
NSLog(@"create");
}
}
2.2 導航條上的backBarButtonItem
同樣的,我們首先從官方文件瞭解一下backBarButtonItem的描述:When this navigation item is immediately below the top item in the stack, the navigation controller derives the back button for the navigation bar from this navigation item. When this property is nil
, the navigation item uses the value in its title
property to create an appropriate back button. If you want to specify a custom image or title for the back button, you can assign a custom bar button item (with your custom title or image) to this property instead. When configuring your bar button item, do not assign a custom view to it; the navigation item ignores custom views in the back bar button anyway.說明了backBarButtonItem只能自定義image和title,不能重寫target or action,系統會忽略其他的相關設定項。
Note: If the title of your back button is too long to fit in the available space on the navigation bar, the navigation bar may substitute the string “Back” in place of the button’s original title. The navigation bar does this only if the back button is provided by the previous view controller. If the new top-level view controller has a custom left bar button item—an object in the leftBarButtonItems
or leftBarButtonItem
property of its navigation item—the navigation bar does not change the button title.這段描述了關於backBarButtonItem的一些特殊點,如果你上一級設定的backBarButtonItem的標題過長(沒有設定則預設是上一級標題),那麼系統可能會自動用“Back/返回”來代替返回按鈕中的標題。此外,如果是自定義的左按鈕,則系統不會修改其值。
2.3 backBarButtonItem和leftBarButtonItem的區別
- backBarButtonItem和另外兩兄弟是有區別的,比如當前有AController準備push到BController,設定backBarButtonItem的title和image需要在AController內設定,在呼叫AController Push:B之前進行設定, ,其他兩兄弟則是在BController的ViewDidload後設置均可。所以,如果我們一定需要重寫返回鍵的action做一些其他的工作,則需要自定義一leftBarButtonItem,因為系統定義leftBarButtonItem的顯示優先順序比backBarButtonItem優先順序高,當存在leftBarButtonItem時,自動忽略backBarButtonItem,達到重寫backBarButtonItem的目的。
AController.navigationItem.backBarButtonItem = ....
- backBarButtonItem的自定義不會影響系統的側滑返回手勢,而leftBarButtonItem的自定義則會禁用側滑返回手勢。
UIButton *backButton = [UIButton buttonWithType:UIButtonTypeCustom];
//對按鈕的個性化設定
UIBarButtonItem *barItem = [[UIBarButtonItem alloc] initWithCustomView:backButton];
self.navigationItem.leftBarButtonItem = barItem; //側滑手勢失效
self.navigationItem.backBarButtonItem = barItem; //不影響側滑手勢
- backBarButtonItem的自定義不能影響返回按鈕的標題和圖片,不會隱藏最左邊的返回箭頭backIndicatorImage,而leftBarButtonItem的自定義則會使最左邊的返回箭頭消失backIndicatorImage。
2.4 各個物件下的backBarButtonItem的區別
這一部分參考自:http://blog.csdn.net/dreamno23/article/details/21085783,還有些沒弄明白,後面有時間再理一理這一塊。
對於導航欄上的按鈕三兄弟,我們在3個類下面都能發現他們,比如當前在一個UIViewController內,輸入以下方法都能發現他們。(同leftBarButtonItem | rightBarButtonItem)
self.navigationItem.backBarButtonItem
self.navigationController.navigationItem.backBarButtonItem
self.navigationController.navigationBar.backItem.backBarButtonItem
比如在AController->BController,在A設定了self.navigationItem.backBarButtonItem,經過試驗發現,這個backBarButtonItem為BController的self.navigationController.navigationBar.backItem.backBarButtonItem。
UIViewController的屬性navigationItem正是被當前UINavigationBar--[UINavigationBar appearance]管理的屬性
//The navigation item used to represent the view controller in a parent’s navigation bar. (read-only)
@property(nonatomic, readonly, retain) UINavigationItem *navigationItem;
self.navigationController.navigationItem.backBarButtonItem則是表示當前navigationController的parent的UINavigationBar,一般情況下沒有這樣的巢狀。