UIStepper 用來讓用戶按步進的方式調整一個數值。外觀上是兩個水平並排的按鈕,一個「+」一個「-」。
它最有意思的特性在於長按:按住「+」或「-」不放,數值會隨按住時長不斷累加,按得越久變化越快。配合最小值與最大值(例如 0 到 99),就能做出順手又精準的數量選擇器。
@property (nonatomic) double value; // 當前值,默認 0.0
@property (nonatomic) double minimumValue; // 最小值,默認 0.0
@property (nonatomic) double maximumValue; // 最大值,默認 100.0
@property (nonatomic) double stepValue; // 每次增減的幅度,默認 1.0
UIStepper 不會直接告訴你方向,只會給出變化後的 value。實用的做法是自己記住上一次的值做對比:
double previousValue; // 記錄上一次的 value
#pragma mark - 創建 UIStepper
- (void)createUIStepper {
UIStepper *stepperButton = [[UIStepper alloc] initWithFrame:CGRectMake(225, 500, 120, 30)];
[stepperButton addTarget:self
action:@selector(controlStepperValue:)
forControlEvents:UIControlEventValueChanged];
stepperButton.maximumValue = 100.0;
stepperButton.minimumValue = 0.0;
stepperButton.value = INITUISTEPPERVALUE;
stepperButton.stepValue = 1.0;
stepperButton.continuous = YES; // 長按連續變化
stepperButton.wraps = NO; // 到邊界不回繞
stepperButton.autorepeat = YES; // 長按持續觸發
[self.view addSubview:stepperButton];
}
#pragma mark - 響應變化
- (void)controlStepperValue:(UIStepper *)stepper {
if (_segment.selectedSegmentIndex == 0) {
if (stepper.value > previousValue) {
CGRect redRect = _redView.frame;
redRect.size.height += 5;
_redView.frame = redRect;
} else {
CGRect redRect = _redView.frame;
redRect.size.height -= 5;
_redView.frame = redRect;
}
previousValue = stepper.value;
} else {
if (stepper.value > previousValue) {
CGRect redRect = _greenView.frame;
redRect.size.height += 5;
_greenView.frame = redRect;
} else {
CGRect redRect = _greenView.frame;
redRect.size.height -= 5;
_greenView.frame = redRect;
}
previousValue = stepper.value;
}
}
// 是否連續觸發。YES:長按會持續變化;NO:抬手後才觸發一次
@property (nonatomic, getter=isContinuous) BOOL continuous;
// 長按是否一直重複觸發
@property (nonatomic) BOOL autorepeat;
// 到達邊界後是否回繞到另一端,默認 NO
@property (nonatomic) BOOL wraps;
這三個屬性容易混淆,可以這樣記:continuous 決定「什麼時候告訴我」,autorepeat 決定「按住時是否反覆告訴我」,wraps 決定「越界後怎麼辦」。
@property (nonatomic, strong) UIColor *tintColor;
// 背景圖
- (void)setBackgroundImage:(UIImage *)image forState:(UIControlState)state;
- (UIImage *)backgroundImageForState:(UIControlState)state;
// 中間分隔線,可分別設置左右兩側狀態
- (void)setDividerImage:(UIImage *)image
forLeftSegmentState:(UIControlState)leftState
rightSegmentState:(UIControlState)rightState;
- (UIImage *)dividerImageForLeftSegmentState:(UIControlState)state
rightSegmentState:(UIControlState)state;
// 加號與減號圖標
- (void)setIncrementImage:(UIImage *)image forState:(UIControlState)state;
- (UIImage *)incrementImageForState:(UIControlState)state;
- (void)setDecrementImage:(UIImage *)image forState:(UIControlState)state;
- (UIImage *)decrementImageForState:(UIControlState)state;
這套 image API 支持按 UIControlState 分別提供素材,因此可以實現按下時的高亮反饋。實踐中最簡單的定制方式其實是只設 tintColor,讓系統自動生成整套配色。
第一,previousValue 必須在初始化時賦一個合理初值,否則第一次點擊會被誤判方向。第二,如果業務允許,把 wraps 打開能避免用戶在邊界反覆點擊卻毫無反應的困惑,但同時要確保下游邏輯能處理回繞。第三,UIStepper 的默認高度較小,點擊區域可能偏窄,建議通過擴大 frame 或增加透明邊距改善可點擊性,這對老年用戶尤其重要。