Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A single-file iOS3+ class designed to be used like an expandable UIButton ; as seen in the iOS Camera app for the "flash" button.
branch: master

This branch is 23 commits behind smartapps-fr:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
DDExpandableButton
DDExpandableButtonSample.xcodeproj
DDExpandableButtonSample
.gitignore
LICENSE
README.md
README.png

README.md

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.

button samples

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.

Something went wrong with that request. Please try again.