一、簡單介紹
1. 什麼是 UIPopoverController
它是 iPad 開發中常見的一種控制器(在 iPhone 上並不允許使用)。與其他控制器不同的是,它直接繼承自 NSObject,而非 UIViewController,只佔用部分螢幕空間來呈現資訊,並且顯示在畫面最上層。

2. 使用步驟
要顯示一個 UIPopoverController,需要經過下列步驟:
(1)設定內容控制器:由於它直接繼承自 NSObject、本身不具備可視化能力,因此上面的內容必須由另一個繼承自 UIViewController 的控制器提供,這個控制器稱為「內容控制器」。
(2)設定內容尺寸:決定顯示時佔據多少螢幕空間。
(3)顯示:決定從哪個位置冒出來。
二、具體步驟
新建一個 iPad 專案。先建立一個繼承自 UITableViewController 的控制器,作為 popover 的內容控制器。

YYMenuViewController.m
#import "YYMenuViewController.h"
@interface YYMenuViewController ()
@property (nonatomic, strong) NSArray *menus;
@end
@implementation YYMenuViewController
- (NSArray *)menus
{
if (_menus == nil) {
_menus = @[@"列表1", @"列表2", @"列表3", @"列表4"];
}
return _menus;
}
- (void)viewDidLoad
{
[super viewDidLoad];
}
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView
{
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
return self.menus.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
static NSString *ID = @"ID";
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];
if (cell == nil) {
cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:ID];
}
cell.textLabel.text = self.menus[indexPath.row];
return cell;
}
@end
YYViewController.m
#import "YYViewController.h"
#import "YYMenuViewController.h"
@interface YYViewController ()
@property (nonatomic, strong) UIPopoverController *popover;
@end
@implementation YYViewController
- (void)viewDidLoad
{
[super viewDidLoad];
}
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
{
// 1. 建立內容控制器
YYMenuViewController *menuVc = [[YYMenuViewController alloc] init];
// 2. 建立 popover 並設定其內容控制器
self.popover = [[UIPopoverController alloc] initWithContentViewController:menuVc];
// 3. 設定尺寸
self.popover.popoverContentSize = CGSizeMake(300, 200);
// 4. 顯示
[self.popover presentPopoverFromBarButtonItem:self.navigationItem.leftBarButtonItem
permittedArrowDirections:UIPopoverArrowDirectionAny
animated:YES];
}
@end
效果如下圖(在 storyboard 中加入了導覽控制器與兩個按鈕):


三、常見報錯
使用 popover 時經常會遇到這個錯誤:
-[UIPopoverController dealloc] reached while popover is still visible.
它的意思是:popover 在仍然可見的時候就被銷毀了(呼叫了 dealloc)。由此可得兩個結論:當 popover 仍舊可見時,不允許銷毀 popover 物件;在銷毀之前,一定要先讓 popover 消失。若上例中不使用全域變數 popover,就會出現這個錯誤。
四、設定尺寸
不建議像下面這樣把 popover 的寬高寫死:
self.popover.popoverContentSize = CGSizeMake(300, 200);
更好的設計是:popover 的尺寸應由內部控制器的內容來決定。內容控制器可以自行設定自己在 popover 中的顯示尺寸,有兩種方法:
(1)iOS 7 之前:@property (nonatomic, readwrite) CGSize contentSizeForViewInPopover;
(2)iOS 7 起:@property (nonatomic) CGSize preferredContentSize;
以上屬性都屬於 UIViewController。範例如下:
- (void)viewDidLoad
{
[super viewDidLoad];
// 設定控制器將來在 popover 中的尺寸
CGFloat maxH = MIN(480, self.menus.count * 44);
// iOS 7 以後
self.preferredContentSize = CGSizeMake(150, maxH);
}
效果如下:

關於 MIN(A, B):最終大小取決於 B,但最大不超過 A,一旦超過 A 則等於 A。
五、設定顯示位置
設定顯示位置有兩種方法:
(1)環繞一個 UIBarButtonItem 顯示(箭頭指向該 UIBarButtonItem):
- (void)presentPopoverFromBarButtonItem:(UIBarButtonItem *)item
permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections
animated:(BOOL)animated;
(2)環繞某一塊特定區域顯示(箭頭指向該區域):
- (void)presentPopoverFromRect:(CGRect)rect
inView:(UIView *)view
permittedArrowDirections:(UIPopoverArrowDirection)arrowDirections
animated:(BOOL)animated;
其中 rect 以 view 的左上角為座標原點。

相關程式碼:
#import "YYViewController.h"
#import "YYMenuViewController.h"
@interface YYViewController () <UIPopoverControllerDelegate>
@property (nonatomic, strong) UIPopoverController *popover;
- (IBAction)buttonClick:(UIButton *)sender;
@end
@implementation YYViewController
- (void)showPopoverFromItem
{
YYMenuViewController *menuVc = [[YYMenuViewController alloc] init];
self.popover = [[UIPopoverController alloc] initWithContentViewController:menuVc];
[self.popover presentPopoverFromBarButtonItem:self.navigationItem.leftBarButtonItem
permittedArrowDirections:UIPopoverArrowDirectionAny
animated:YES];
self.popover.delegate = self;
}
#pragma mark - 代理方法
// popover 消失時呼叫
- (void)popoverControllerDidDismissPopover:(UIPopoverController *)popoverController
{
}
// popover 位置改變時呼叫(如豎屏變橫屏)
- (void)popoverController:(UIPopoverController *)popoverController
willRepositionPopoverToRect:(inout CGRect *)rect
inView:(inout UIView *__autoreleasing *)view
{
}
// 決定使用者點擊蒙版後 popover 是否可以 dismiss
- (BOOL)popoverControllerShouldDismissPopover:(UIPopoverController *)popoverController
{
return NO;
}
- (IBAction)buttonClick:(UIButton *)sender {
YYMenuViewController *menuVc = [[YYMenuViewController alloc] init];
self.popover = [[UIPopoverController alloc] initWithContentViewController:menuVc];
// 注意 sender.frame 與 sender.bounds 的區別
[self.popover presentPopoverFromRect:sender.bounds inView:sender
permittedArrowDirections:UIPopoverArrowDirectionAny
animated:YES];
}
@end
部分界面效果:


以下兩種寫法是等價的,也就是說,若讓箭頭指向某個 UIView(例如一個 button),有兩種做法:
// 方法 1
[popover presentPopoverFromRect:button.bounds inView:button
permittedArrowDirections:UIPopoverArrowDirectionDown animated:YES];
// 方法 2
[popover presentPopoverFromRect:button.frame inView:button.superview
permittedArrowDirections:UIPopoverArrowDirectionDown animated:YES];

六、設定代理
相關屬性與方法:
@property (nonatomic, assign) id <UIPopoverControllerDelegate> delegate; @property (nonatomic, readonly, getter=isPopoverVisible) BOOL popoverVisible; @property (nonatomic, readonly) UIPopoverArrowDirection popoverArrowDirection; - (void)dismissPopoverAnimated:(BOOL)animated;
七、防止點擊 popover 區域外時消失
預設情況下,只要 popover 顯示在螢幕上,其背後的所有控制項都無法正常與使用者互動,點擊區域外的控制項時 popover 會預設消失。若想讓點擊區域外時不消失,可以設定 passthroughViews 屬性:
@property (nonatomic, copy) NSArray *passthroughViews;
這個屬性用來指定 popover 顯示時哪些控制項仍可正常互動,如此點擊區域外的控制項便不會讓 popover 消失。
- (IBAction)buttonClick:(UIButton *)sender {
YYMenuViewController *menuVc = [[YYMenuViewController alloc] init];
self.popover = [[UIPopoverController alloc] initWithContentViewController:menuVc];
// 設定過濾掉一些控制項
self.popover.passthroughViews = @[self.switchview];
[self.popover presentPopoverFromRect:sender.frame inView:sender.superview
permittedArrowDirections:UIPopoverArrowDirectionAny
animated:YES];
}
補充:UIPopoverController 這個類別只能用在 iPad 上。若想在手機上實現類似 popover 的效果,必須自訂 view。