DDExpandableButton

Purpose

DDExpandableButton is a single-file iOS 3.0+ class designed to be used like an expandable UIButton ; as seen in the iOS Camera app for the flash button.

Originally inspired by ExpandyButton.

Properties

A DDExpandableButton has the following properties:

@property (nonatomic,assign) BOOL expanded;
Current button status (if expanded or shrunk).
@property (nonatomic,assign) BOOL useAnimation;
Use animation during button state transitions.
@property (nonatomic,assign) BOOL toggleMode;
Use button as a toggle (like "HDR On" / "HDR Off" button in camera app).
@property (nonatomic,assign) CGFloat timeout;
To shrink the button after a timeout. Use 0 if you want to disable timeout.
@property (nonatomic,assign) CGFloat horizontalPadding;
Horizontal padding space between items.
@property (nonatomic,assign) CGFloat verticalPadding;
Vertical padding space above and below items.
@property (nonatomic,assign) CGFloat borderWidth;
Width (thickness) of the button border.
@property (nonatomic,assign) CGFloat innerBorderWidth;
Width (thickness) of the inner borders between items.
@property (nonatomic,assign) NSUInteger selectedItem;
Selected item number.
@property (nonatomic,retain) UIColor *borderColor;
Color of the button and inner borders.
@property (nonatomic,retain) UIColor *textColor;
Color of text labels.
@property (nonatomic,retain) UIFont *labelFont;
Font of text labels.
@property (nonatomic,retain) UIFont *unSelectedLabelFont;
Font of unselected text labels. Nil if not different from labelFont.
@property (nonatomic,readonly) NSArray *labels;
Access UIView used to draw labels.

Methods

A DDExpandableButton has the following methods:

- (id)initWithPoint:(CGPoint)point leftTitle:(id)leftTitle buttons:(NSArray *)buttons;
Init method where you can specify leftTitle and buttons.
- (void)setSelectedItem:(NSUInteger)selected animated:(BOOL)animated;
Animated version of - (void)setSelectedItem:(NSUInteger)selected.
- (void)setExpanded:(BOOL)expanded animated:(BOOL)animated;
Animated version of - (void)setExpanded:(BOOL)expanded.
- (void)setLeftTitle:(id)leftTitle;
Set left title view : you can use a NSString, an UIImage or any UIView (but the view must implement DDExpandableButtonViewSource protocol).
- (void)setButtons:(NSArray *)buttons;
Set buttons views : you can use a NSString, an UIImage or any UIView (but the view must implement DDExpandableButtonViewSource protocol).
- (void)disableTimeout;
If you want to disable timeout shrunk. You can set timeout to 0 also.
- (void)updateDisplay;
When modifying button parameters, use this method to update button display.

Protocols

The DDExpandableButtonViewSource protocol, used when you specify the title or the different buttons, has the following methods:

- (CGSize)defaultFrameSize;
Returns default frame size of the view, used when expanding the button.
- (void)setHighlighted:(BOOL)highlighted;
Optional, used to change appearance of selected items.

Usage

Example : a button with four text labels and a hook when value change.

NSArray *buttons = [NSArray arrayWithObjects:@"Black", @"Red", @"Green", @"Blue", nil];
DDExpandableButton *colorButton = [[[DDExpandableButton alloc] initWithPoint:CGPointMake(20, 70) leftTitle:@"Color" buttons:buttons] autorelease];
[[self view] addSubview:colorButton];
[colorButton addTarget:self action:@selector(toggleColor:) forControlEvents:UIControlEventValueChanged];

License

DDExpandableButton is available under the MIT license. See the LICENSE file for more info.

RongjieChen / DDExpandableButton