iOS UIButton disabled 狀態不自動變暗自訂圖片

問題現象

設定 button.enabled = NO 時，自訂圖片的 UIButton 不會自動變暗 (預設系統行為會對圖片套用灰階/透明度)。

原因

UIButton 預設的 adjustsImageWhenDisabled 僅對**系統繪製**內容 (如文字、系統圖示) 生效，對 setImage:forState: 設定的自訂圖片**不自動處理**。

解決方案一：手動設定 Disabled 狀態圖片 (最簡單)

// 方法 1：直接用正常狀態圖片作為 disabled 圖片 (不變暗)
UIImage *normalImage = [button imageForState:UIControlStateNormal];
[button setImage:normalImage forState:UIControlStateDisabled];

// 方法 2：提供專門的 disabled 圖片 (灰階版)
[button setImage:[UIImage imageNamed:@"btn_normal"] forState:UIControlStateNormal];
[button setImage:[UIImage imageNamed:@"btn_disabled"] forState:UIControlStateDisabled];

解決方案二：子類化 UIButton 覆寫 setEnabled: (通用)

@interface CustomButton : UIButton
@end

@implementation CustomButton

- (void)setEnabled:(BOOL)enabled {
    [super setEnabled:enabled];
    
    // 手動控制 alpha 模擬變暗效果
    self.imageView.alpha = enabled ? 1.0 : 0.5;
    // 或套用濾鏡 (iOS 13+)
    // if (@available(iOS 13.0, *)) { ... }
}

@end

解決方案三：使用圖片渲染模式 (iOS 7+)

// 設定圖片為 Template 模式，可跟隨 tintColor 自動變色
UIImage *img = [UIImage imageNamed:@"btn_icon"];
img = [img imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];
[button setImage:img forState:UIControlStateNormal];

// 設定按鈕 tintColor，disabled 時會自動變為灰色
button.tintColor = [UIColor blueColor]; // 正常藍色
// disabled 時系統自動將 tintColor 變為灰色 (需 button.adjustsImageWhenDisabled = YES)

完整屬性對照表

最佳實踐建議

1. 設計圖片組：美術提供 Normal、Highlighted、Disabled、Selected 四套圖片
2. 使用 Asset Catalog：在 .xcassets 中設定各狀態圖片，代碼僅需 setImage:forState:
3. Template 模式：單色圖示用 AlwaysTemplate + tintColor，自動適配深色模式、啟用狀態
4. 避免依賴 adjustsImageWhenDisabled：對自訂圖片無效，明確設定各狀態圖片