UIButton 是最常用的 UI 元件之一。有個細節值得先說:它的物件建立方式與多數 view 不同,通常走類別方法而非 init。
+ (id)buttonWithType:(UIButtonType)buttonType;
如果你改用 init 建立:
UIButton *button = [[UIButton alloc] initWithFrame:CGRectMake(100, 300, 100, 50)]; [button setTitle:@"asd" forState:UIControlStateNormal];
物件建立完全正常,但執行後螢幕上什麼都看不到。這不是 bug——用 init 建立的按鈕,標題文字預設是白色,在白底或沒設背景色的畫面上自然隱形。換個深色背景或自行設定文字顏色就能確認。
類別方法需要傳入一個 UIButtonType 參數,它是列舉:
typedef NS_ENUM(NSInteger, UIButtonType) {
UIButtonTypeCustom = 0, // 自訂型別,等同 init 的效果
UIButtonTypeSystem, // 標準型別,一般情況的首選(iOS 7.0 起)
UIButtonTypeDetailDisclosure, // 標準外觀加上藍色 information 標誌
UIButtonTypeInfoLight, // information 標誌較亮
UIButtonTypeInfoDark, // information 標誌較暗
UIButtonTypeContactAdd, // 標準外觀加上加號標誌
UIButtonTypeRoundedRect = UIButtonTypeSystem // 已不建議使用,由 System 取代
};
除 Custom 以外,其餘型別的預設文字色都是藍色,連放上去的圖片也會被染成藍色。只有 Custom 才能原色顯示圖片。另外,同時設定圖片與文字時,預設排列是圖片在左、文字在右。
// 設定標題文字 - (void)setTitle:(NSString *)title forState:(UIControlState)state; // 設定圖片 - (void)setImage:(UIImage *)image forState:(UIControlState)state; // 設定背景圖片,它會鋪在文字下方,而不是排在文字左邊 - (void)setBackgroundImage:(UIImage *)image forState:(UIControlState)state; // 設定標題文字顏色 - (void)setTitleColor:(UIColor *)color forState:(UIControlState)state;
其中 UIControlState 是位元遮罩列舉:
typedef NS_OPTIONS(NSUInteger, UIControlState) {
UIControlStateNormal = 0, // 正常
UIControlStateHighlighted = 1 << 0, // 高亮:按下時進入,放開自動回正常
UIControlStateDisabled = 1 << 1, // 不可用,由 enabled 屬性控制
UIControlStateSelected = 1 << 2, // 已選取,由 selected 屬性控制
UIControlStateApplication = 0x00FF0000, // 保留給應用程式使用
UIControlStateReserved = 0xFF000000 // 保留給內部框架使用
};
常見用法是為不同狀態給不同外觀:
[button setTitle:title1 forState:UIControlStateNormal]; [button setTitle:title2 forState:UIControlStateHighlighted];
這樣平時顯示 title1,按下時變成 title2,放開又回到 title1。圖片同理。
要特別提醒:為不同狀態設定不同圖片時,尺寸必須一致,否則切換瞬間會出現跳動或錯位。
setTitleColor: 只影響文字,不動圖片;而 tintColor 屬性會同時影響文字與圖片,但不影響背景圖。此外,若按鈕是以 UIButtonTypeCustom 或 init 建立,tintColor 不會生效。
- (void)addTarget:(id)target action:(SEL)action forControlEvents:(UIControlEvents)controlEvents;
意思是當 controlEvents 發生時,呼叫 target 的 action 方法(用 Objective-C 的說法,就是對 target 送出 action 訊息)。
typedef NS_OPTIONS(NSUInteger, UIControlEvents) {
UIControlEventTouchDown = 1 << 0, // 按下
UIControlEventTouchDownRepeat = 1 << 1, // 連續點擊(次數由 touchscreens 決定)
UIControlEventTouchDragInside = 1 << 2, // 在控制項內部拖動
UIControlEventTouchDragOutside = 1 << 3, // 拖出控制項外
UIControlEventTouchDragEnter = 1 << 4, // 從外部拖入
UIControlEventTouchDragExit = 1 << 5, // 拖出後離開
UIControlEventTouchUpInside = 1 << 6, // 在內部抬起(發生在 TouchDown 之後)
UIControlEventTouchUpOutside = 1 << 7, // 拖到外部才抬起
UIControlEventTouchCancel = 1 << 8, // 手勢被取消,例如來電、鎖屏
UIControlEventValueChanged = 1 << 12, // 數值變化,多用於 UISlider 等
UIControlEventEditingDidBegin = 1 << 16, // 開始編輯(成為第一響應者)
UIControlEventEditingChanged = 1 << 17, // 文字改變
UIControlEventEditingDidEnd = 1 << 18, // 結束編輯
UIControlEventEditingDidEndOnExit = 1 << 19, // 按下 return 鍵結束編輯
UIControlEventAllTouchEvents = 0x00000FFF, // 所有觸控事件
UIControlEventAllEditingEvents = 0x000F0000, // 所有編輯事件
UIControlEventApplicationReserved = 0x0F000000, // 供應用程式使用的範圍
UIControlEventSystemReserved = 0xF0000000, // 供框架內部使用的範圍
UIControlEventAllEvents = 0xFFFFFFFF // 所有事件
};
實際開發中最常用的是 UIControlEventTouchUpInside。TouchDown 就觸發會導致使用者手指按著還沒放開就執行完畢,體驗很差;TouchUpInside 才符合「按下、放開才算點擊」的直覺。
- (void)removeTarget:(id)target action:(SEL)action forControlEvents:(UIControlEvents)controlEvents;
作用是取消先前綁定的回應。前提是之前確實添加過,且三個參數若設為 nil 代表「任意/全部」,也就是一次移除所有綁定。cell 複用的場景中,這個方法偶爾會用來清掉殘留的舊 binding。