/JTHamburgerButton

An animated hamburger button for iOS.

Primary LanguageObjective-CMIT LicenseMIT

JTHamburgerButton

CI Status Version License Platform

An animated hamburger button for iOS.

Installation

With CocoaPods, add this line to your Podfile.

pod 'JTHamburgerButton', '~> 1.0'

Screenshots

Example

Usage

Basic usage

#import <UIKit/UIKit.h>

#import <JTHamburgerButton.h>

@interface ViewController : UIViewController

@property (weak, nonatomic) IBOutlet JTHamburgerButton *button;

@end
#import "ViewController.h"

@implementation ViewController

- (IBAction)didBackButtonTouch:(JTHamburgerButton *)sender
{
    if(sender.currentMode == JTHamburgerButtonModeHamburger){
        [sender setCurrentModeWithAnimation:JTHamburgerButtonModeArrow];
    }
    else{
        [sender setCurrentModeWithAnimation:JTHamburgerButtonModeHamburger];
    }
}

- (IBAction)didCloseButtonTouch:(JTHamburgerButton *)sender
{
    if(sender.currentMode == JTHamburgerButtonModeHamburger){
        [sender setCurrentModeWithAnimation:JTHamburgerButtonModeCross];
    }
    else{
        [sender setCurrentModeWithAnimation:JTHamburgerButtonModeHamburger];
    }
}

@end

The method setCurrentModeWithAnimation animates the transition from one mode to another. There is also setCurrentMode which changes the view without transition.

There are three modes:

  • JTHamburgerButtonModeHamburger
  • JTHamburgerButtonModeArrow
  • JTHamburgerButtonModeCross

Customize the design

  • lineHeight
  • lineWidth
  • lineSpacing
  • lineColor
  • animationDuration

After the change of one of this properties you have to call updateAppearance to update the view.

Requirements

  • iOS 7 or higher
  • Automatic Reference Counting (ARC)

Author

License

JTHamburgerButton is released under the MIT license. See the LICENSE file for more info.