您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 長按菜單 UIMenuController 實戰:從系統預設到自定義按鈕

編輯:iOS 相關教學

UIMenuController 就是我們長按文字或某個視圖時,從下方浮出的那條操作菜單。很多人第一次用它會覺得莫名其妙:明明寫了代碼,菜單卻死活不出來。原因通常在於忽略了一個前提——這套機制的顯示與互動,並不是由菜單對象自己決定的。

一、UIMenuController 的依賴關係

菜單必須依附在某個 view 上呈現,而它的所有互動則交給該 view 所屬響應鏈中的 Responder 去處理。舉個例子:如果菜單顯示在當前 ViewController 的 view 上,那麼菜單裡每個選項被點擊後的行為,就由這個 ViewController 負責。理解這一點,後面的代碼就很順了。

二、讓菜單成功顯示的三個條件

需要同時滿足以下三點:

1. 當前 Responder 處於第一響應者狀態;
2. 調用 UIMenuController 的 menuVisible 相關設置;
3. 當前 Responder 實現下面兩個方法:

// 能否成為第一響應者
-(BOOL)canBecomeFirstResponder{
    return YES;
}

// 能否接收菜單上的某項操作
-(BOOL)canPerformAction:(SEL)action withSender:(id)sender{
    return YES;
}

具備以上條件後,用下面的代碼就能把菜單喚出來:

[self becomeFirstResponder];

// setTargetRect 決定菜單指向的位置,inView 決定它所在的視圖
[[UIMenuController sharedMenuController] setTargetRect:frame inView:self.view];

// 讓菜單可見
[UIMenuController sharedMenuController].menuVisible = YES;

三、canPerformAction:withSender: 的雙重職責

這個方法很關鍵,它承擔了兩件事。

第一次被調用時,系統用它判斷「菜單要不要顯示」:返回 NO 直接不顯示,返回 YES 才繼續。此後系統會反覆調用這個方法,逐一確認當前 Responder 是否實現了菜單上各選項對應的觸發方法——實現了,該按鈕才會出現;沒實現,就被過濾掉。

所以實務上的做法是:在方法內部判斷 action,只放行你想讓使用者看到的選項。例如只保留剪切與複製:

-(BOOL)canPerformAction:(SEL)action withSender:(id)sender{
    if (action == @selector(cut:) || action == @selector(copy:)){
        return YES;
    }
    return NO;
}

四、系統內建的動作方法

以下方法都宣告在 UIResponder 中,實現它們對應的按鈕就會自動出現在菜單上:

// 剪切
- (void)cut:(nullable id)sender NS_AVAILABLE_IOS(3_0);
// 複製
- (void)copy:(nullable id)sender NS_AVAILABLE_IOS(3_0);
// 粘貼
- (void)paste:(nullable id)sender NS_AVAILABLE_IOS(3_0);
// 選擇
- (void)select:(nullable id)sender NS_AVAILABLE_IOS(3_0);
// 全選
- (void)selectAll:(nullable id)sender NS_AVAILABLE_IOS(3_0);
// 刪除
- (void)delete:(nullable id)sender NS_AVAILABLE_IOS(3_2);
// 書寫方向改為從左到右
- (void)makeTextWritingDirectionLeftToRight:(nullable id)sender NS_AVAILABLE_IOS(5_0);
// 書寫方向改為從右到左
- (void)makeTextWritingDirectionRightToLeft:(nullable id)sender NS_AVAILABLE_IOS(5_0);

除了這些公開方法,系統內部還存在一批私有方法,對應「替換」「簡繁轉換」「定義」「分享」等項目:

// 替換
- (void)_promptForReplace:(id)arg1{ NSLog(@"promptForReplace"); }
// 簡繁轉換
-(void)_transliterateChinese:(id)sender{ NSLog(@"transliterateChinese"); }
// 文字風格
-(void)_showTextStyleOptions:(id)sender{ NSLog(@"showTextStyleOptions"); }
// 定義
-(void)_define:(id)sender{ NSLog(@"define"); }
-(void)_addShortcut:(id)sender{ NSLog(@"addShortcut"); }
-(void)_accessibilitySpeak:(id)sender{ NSLog(@"accessibilitySpeak"); }
// 朗讀語言選擇
-(void)_accessibilitySpeakLanguageSelection:(id)sender{ NSLog(@"accessibilitySpeakLanguageSelection"); }
// 暫停朗讀
-(void)_accessibilityPauseSpeaking:(id)sender{ NSLog(@"accessibilityPauseSpeaking"); }
// 分享
-(void)_share:(id)sender{ NSLog(@"share"); }

這些方法名以底線開頭,屬於私有實現,會隨系統版本變動,上架的 App 不應該依賴它們。

五、正確做法:用 UIMenuItem 自定義

想要自定義選項,不必碰私有方法,UIMenuItem 就是為此而生的:

[self becomeFirstResponder];

UIMenuItem *item = [[UIMenuItem alloc] initWithTitle:@"自定義" action:@selector(newFunc)];

[[UIMenuController sharedMenuController] setTargetRect:[sender frame] inView:self.view];
[UIMenuController sharedMenuController].menuItems = @[item];
[UIMenuController sharedMenuController].menuVisible = YES;

-(BOOL)canBecomeFirstResponder{
    return YES;
}

-(BOOL)canPerformAction:(SEL)action withSender:(id)sender{
    if (action == @selector(newFunc)){
        return YES;
    }
    return NO;
}

-(void)newFunc{
    NSLog(@"自定義方法");
}

六、控制菜單的指向方向

菜單旁邊那個小箭頭的朝向,可以通過 arrowDirection 指定:

// 箭頭方向
@property(nonatomic) UIMenuControllerArrowDirection arrowDirection;

/*
typedef NS_ENUM(NSInteger, UIMenuControllerArrowDirection) {
    UIMenuControllerArrowDefault,  // 預設,依螢幕位置自動朝上或朝下
    UIMenuControllerArrowUp,       // 箭頭朝上
    UIMenuControllerArrowDown,     // 箭頭朝下
    UIMenuControllerArrowLeft,     // 箭頭朝左
    UIMenuControllerArrowRight,    // 箭頭朝右
};
*/

七、踩坑清單

菜單出不來,通常就是下面幾條沒做到:

1. canBecomeFirstResponder 必須返回 YES;
2. canPerformAction:withSender: 中,所有你想顯示的選項(含系統選項)都要返回 YES;
3. 顯示前必須先調用 [self becomeFirstResponder],成為第一響應者;
4. 如果要連續彈出第二個菜單,得先把它關掉再重新顯示,否則不會出現:

[menuController setMenuVisible:NO];

另外提醒一點:菜單消失後記得執行 resignFirstResponder,否則第一響應者狀態一直被你佔著,其他控件的快捷操作會跟著失效。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved