navigation和NavigationControllerDelegate的文檔說明

iOS開發UINavigation系列四——導航控制器UINavigationController
一、引言
二、導航控制器的創建和controller的管理
三、導航控制器中的常用方法和屬性
四、iOS8后導航的新特性
五、UINavigationDelegate
六、與UIViewController相關
iOS開發UINavigation系列四——導航控制器UINavigationController

一、引言

    在前面的博客中,我么你介紹了UINavigationBar,UINavigationItem和UIToolBar,UINavigationController是將這些控件和UIViewController緊密的結合了起來,使用導航,我們的應用程序層次會更加分明,對controller的管理也更加方便。前幾篇博客地址如下:

UINavigationBar:http://my.oschina.net/u/2340880/blog/527706

UINavigationItem:http://my.oschina.net/u/2340880/blog/527781

UIToolBar:http://my.oschina.net/u/2340880/blog/528168

二、導航控制器的創建和controller的管理

    導航控制器是一個堆棧結構,只是其中管理的對象是controller,通過push與pop進行controller的切換,我們有兩種方式可以創建導航控制器:

?
1
2
3
4
//通過一個自定義的導航欄和工具欄創建導航控制器

  • (instancetype)initWithNavigationBarClass:(nullable Class)navigationBarClass toolbarClass:(nullable Class)toolbarClass;
    //使用系統默認的導航欄和工具欄,通過一個根視圖創建導航控制器
  • (instancetype)initWithRootViewController:(UIViewController *)rootViewController;
    通過以下方法對視圖控制器進行管理操作:

?
1
2
3
4
5
6
7
8
9
10
//設置管理的視圖控制器

  • (void)setViewControllers:(NSArray<UIViewController *> *)viewControllers animated:(BOOL)animated;
    //壓入新的視圖控制器
  • (void)pushViewController:(UIViewController *)viewController animated:(BOOL)animated;
    //彈出一個視圖控制器 返回的是pop的controller
  • (nullable UIViewController *)popViewControllerAnimated:(BOOL)animated;
    //彈出到某個視圖控制器 返回所有pop的controller
  • (nullable NSArray<__kindof UIViewController *> *)popToViewController:(UIViewController *)viewController animated:(BOOL)animated;
    //直接pop到根視圖控制器,返回所有被pop的controller
  • (nullable NSArray<__kindof UIViewController *> *)popToRootViewControllerAnimated:(BOOL)animated;
    三、導航控制器中的常用方法和屬性

?
1
2
3
4
//返回棧頂的controller
@property(nullable, nonatomic,readonly,strong) UIViewController *topViewController;
//返回顯示的controller
@property(nullable, nonatomic,readonly,strong) UIViewController *visibleViewController;
上面兩個方法的區別在于,topViewController是返回被push出的最后一個controller,但是如果之后又有present進行莫泰跳轉,visibleViewController會返回當前顯示的controller。例如A-push-B-present-C,則topViewController會返回B,visibleViewController會返回C。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
//返回堆棧中所有的controller
@property(nonatomic,copy) NSArray<__kindof UIViewController *> *viewControllers;
//設置隱藏導航欄
@property(nonatomic,getter=isNavigationBarHidden) BOOL navigationBarHidden;

  • (void)setNavigationBarHidden:(BOOL)hidden animated:(BOOL)animated;
    //導航欄對象,只讀屬性
    @property(nonatomic,readonly) UINavigationBar *navigationBar;
    //隱藏狀態欄
    @property(nonatomic,getter=isToolbarHidden) BOOL toolbarHidden NS_AVAILABLE_IOS(3_0);
  • (void)setToolbarHidden:(BOOL)hidden animated:(BOOL)animated;
    //狀態欄對象
    @property(null_resettable,nonatomic,readonly) UIToolbar *toolbar;
    //導航中的返回手勢對象
    //iOS7之后,在導航中右劃會進行pop操作,設置這個的enable可以控制設置手勢是否失效
    @property(nullable, nonatomic, readonly) UIGestureRecognizer *interactivePopGestureRecognizer;
    四、iOS8后導航的新特性

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
//這個方法是為了iOS方法的命名統一,在導航中,其作用和push一樣

  • (void)showViewController:(UIViewController *)vc sender:(nullable id)sender;
    //彈出鍵盤的時候隱藏導航欄
    @property (nonatomic, readwrite, assign) BOOL hidesBarsWhenKeyboardAppears;
    //屏幕滑動的時候隱藏導航欄,常用于tableView,上滑隱藏導航欄,下滑顯示,帶動畫效果
    @property (nonatomic, readwrite, assign) BOOL hidesBarsOnSwipe;
    //滑動隱藏導航欄的手勢
    @property (nonatomic, readonly, strong) UIPanGestureRecognizer *barHideOnSwipeGestureRecognizer;
    //橫屏的時候隱藏導航欄
    @property (nonatomic, readwrite, assign) BOOL hidesBarsWhenVerticallyCompact;
    //敲擊屏幕可以隱藏與顯示導航欄
    @property (nonatomic, readwrite, assign) BOOL hidesBarsOnTap;
    //敲擊屏幕的手勢
    @property (nonatomic, readonly, assign) UITapGestureRecognizer *barHideOnTapGestureRecognizer;
    iOS8中增加的這些方法,不得不說著實在用戶體驗生進了一大步,從中也可以看出apple對于用戶體驗度的用心。

五、UINavigationDelegate

    導航控制器還提供了一些代理回調方法,如下:

?
1
2
3
4
5
6
7
8
9
10
11
//視圖將要展示時調用的方法

  • (void)navigationController:(UINavigationController *)navigationController willShowViewController:(UIViewController *)viewController animated:(BOOL)animated;
    //視圖已經展示時調用的方法

  • (void)navigationController:(UINavigationController *)navigationController didShowViewController:(UIViewController *)viewController animated:(BOOL)animated;
    //設置方法設置導航控制器支持的設備方向

  • (UIInterfaceOrientationMask)navigationControllerSupportedInterfaceOrientations:(UINavigationController *)navigationController NS_AVAILABLE_IOS(7_0);
    //這個方法設置導航控制器的首選設備方向

  • (UIInterfaceOrientation)navigationControllerPreferredInterfaceOrientationForPresentation:(UINavigationController *)navigationController NS_AVAILABLE_IOS(7_0);
    //下面兩個方法可以對導航的轉場動畫進行設置

  • (nullable id <UIViewControllerInteractiveTransitioning>)navigationController:(UINavigationController *)navigationController interactionControllerForAnimationController:(id <UIViewControllerAnimatedTransitioning>) animationController;

  • (nullable id <UIViewControllerAnimatedTransitioning>)navigationController:(UINavigationController *)navigationController animationControllerForOperation:(UINavigationControllerOperation)operation fromViewController:(UIViewController *)fromVC toViewController:(UIViewController *)toVC ;
    六、與UIViewController相關

      當一個controller被添加到導航中后,系統會為它分配一些屬性,如下:
    

?
1
2
3
4
5
6
//當前controller對應的導航項
@property(nonatomic,readonly,strong) UINavigationItem *navigationItem;
//push的時候隱藏底部欄,如push后隱藏tabbar
@property(nonatomic) BOOL hidesBottomBarWhenPushed;
//管理它的導航控制器
@property(nullable, nonatomic,readonly,strong) UINavigationController *navigationControll

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,546評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,570評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,505評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,017評論 1 313
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,786評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,219評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,287評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,438評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,971評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,796評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,995評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,540評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,230評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,662評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,918評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,697評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,991評論 2 374

推薦閱讀更多精彩內容