Skip to content

Latest commit

 

History

History
208 lines (153 loc) · 7.58 KB

README.md

File metadata and controls

208 lines (153 loc) · 7.58 KB

HTPressableButton

Build Status

HTPressableButton is designed for iOS developers to be able to spend time developing ideas, not building basic buttons. These stylish and flat-designed buttons can easily be modified and are perfect for almost any project. With no worry over color choice, HTPressableButton also includes beautiful color schemes that perfectly suit with your app.

Compatible with: iOS 6.0 and above

Current Version: 1.3.3

You can check out our documentation here. Installation

HTPressableButton can be installed via CocoaPods

pod 'HTPressableButton'

You may also quickly try the HTPressableButton example project with

pod try 'HTPressableButton'

However, if you are only interested to use the color scheme provided (shown below) then

pod 'HTPressableButton/HTColor'

Another option is to use git submodules or just download it and include it in your project manually.

NOTE: Please be reminded to add the header files to your project. You may add only the one that you'll use.

#import "HTPressableButton.h"
#import "UIColor+HTColor.h"

Button Types

IMPORTANT: You must specify the frame first. We'd like to know the size of your button first.

###Rectangular Button

    //Rectangular grape fruit color button
    CGRect frame = CGRectMake(30, 150, 260, 50);
    HTPressableButton *rectButton = [[HTPressableButton alloc] initWithFrame:frame buttonStyle:HTPressableButtonStyleRect];
    rectButton.buttonColor = [UIColor ht_grapeFruitColor];
    rectButton.shadowColor = [UIColor ht_grapeFruitDarkColor];
    [rectButton setTitle:@"Rect" forState:UIControlStateNormal];
    [self.view addSubview:rectButton];

HTPressableButton


###Rounded Rectangular Button

    // Rounded rectangular default color button
	frame = CGRectMake(30, 230, 260, 50);
    HTPressableButton *roundedRectButton = [[HTPressableButton alloc] initWithFrame:frame buttonStyle:HTPressableButtonStyleRounded];
    [roundedRectButton setTitle:@"Rounded" forState:UIControlStateNormal];
    [self.view addSubview:roundedRectButton];

HTPressableButton


###Circular Button

	//Circular mint color button
    frame = CGRectMake(110, 300, 100, 100);
    HTPressableButton *circularButton = [[HTPressableButton alloc] initWithFrame:frame buttonStyle:HTPressableButtonStyleCircular];
    circularButton.buttonColor = [UIColor ht_mintColor];
    circularButton.shadowColor = [UIColor ht_mintDarkColor];
    [circularButton setDisabledButtonColor:[UIColor ht_sunflowerColor]];
    [circularButton setTitle:@"Circular" forState:UIControlStateNormal];
    [self.view addSubview:circularButton];

HTPressableButton


###Disabled Button If you wish to create a disabled button, add:

	buttonNameHere.enabled = NO;

Example:

    //Disabled rounded rectangular button
    frame = CGRectMake(30, 420, 260, 50);
    HTPressableButton *disabledRoundedRectButton = [[HTPressableButton alloc] initWithFrame:frame buttonStyle:HTPressableButtonStyleRounded];
    disabledRoundedRectButton.disabledButtonColor = [UIColor ht_pinkRoseColor];
    disabledRoundedRectButton.disabledShadowColor = [UIColor ht_pinkRoseDarkColor];
    disabledRoundedRectButton.alpha = 0.5;
    disabledRoundedRectButton.enabled = NO;
    [disabledRoundedRectButton setTitle:@"DisabledButton" forState:UIControlStateNormal];
    [self.view addSubview:disabledRoundedRectButton];

HTPressableButton

The default alpha value is 1.0 for all type of buttons. The value can be changed (like the above disabled button) by:

	buttonNameHere.alpha = 0.5;

NOTE: We have set some default properties for you.

Property Values
Button Type HTPressableButtonStyleRounded
Corner Radius 10.0
Font Avenir
Font Size 18
Shadow Height 17% of the button's height
Button Color ht_jayColor
Button Shadow Color ht_jayDarkColor
Disabled Button Color ht_mediumColor
Disabled Button Shadow Color ht_mediumDarkColor

If you wish to set your own shadow height instead of using our default value, add:

	//Set shadow height of size 10
	buttonNameHere.shadowHeight = 10;

The different types of buttons have different default value set for its corner radius, you can modify it by:

    //Set corner radius to 20.0
    buttonNameHere.cornerRadius = 20;

To change the font of the button:

    //Set button font
    buttonNameHere.titleFont = [UIFont fontWithName:@"Avenir" size:18];

###Additional Colors You can freely use the additional colors in the file UIColors+HTColor anywhere in your project by:

    [UIColor ht_colorNameHere]
    
    //Examples
    [UIColor ht_jayColor]
    [UIColor ht_pinkRoseColor]

HTPressableButton



Contributors

Welcome contributors! Please don't hesitate to make an issue or pull request :)

####Maintainers He Rin Kim Thanakron Tandavas
####Contributors Paul Williamson Ben Manoj Mahapatra Pitiphong Phongpattranont Alexsander Akers Naji Dmeiri

Showcase

We would love to see how we became a part of your project. Send us an email, issue, tweet, or etc. and we'll update it here!

License

This project is licensed under the terms of the MIT license.

Credits

Inspired by: