UICustomActionSheet
Fully customizable UIActionSheet
replacement. Compatible with iOS 7, 8 and 9.
This ัustom ActionSheet can also emphasize the element the menu is related to, by blurring the background of the presenting view. The element itself remains clear.
How to use
Simply init UICustomActionSheet object in the same way you do with UIActionSheet:
UICustomActionSheet *actionSheet = [[UICustomActionSheet alloc] initWithTitle:@"Hello World" delegate:self buttonTitles:@[@"Bottom button",@"Top button"]];
Feel free to set nil
for title
if you don't want it to be shown in your ActionSheet. To present UICustomActionSheet in the view, you may use the same method as in UIActionSheet:
[actionSheet showInView:self.view];
For handling UICustomActionSheet's events, presenting controller must implement UICustomActionSheetDelegate
's method:
-(void)customActionSheet:(UICustomActionSheet *)customActionSheet clickedButtonAtIndex:(NSInteger)buttonIndex{
NSLog(@"%d",buttonIndex);
}
Do any customization stuff you need:
Customization using methods
-(void)setButtonColors:(NSArray *)colors
- method to set an array of buttons colors. If colors
array contains less elements than buttons number in UICustomActionSheet, only first [colors count]
buttons will be colored with given in array colors, all next buttons will be colored with tintColor
(default grayColor
)
-(void)setTitle:(NSString *)title andSubtitle:(NSString *)subtitle
- set title and subtitle to UICustomActionSheet. Both values are nil
as default.
-(void)clearLayer:(CALayer *)layer withCenter:(CGPoint)point
- highlights layer
using animation. (moves layer from point
to screen center)
Customization using properties
Colors
tintColor
- standard color for UICustomActionSheet's buttons
backgroundColor
- color for panel background. Set it with [UIColor clearColor]
value to make it transparent
blurTintColor
- translucent color for tinting UICustomActionSheet's background in case blurredBackground = YES
. The default value is [UIColor colorWithWhite:0.1 alpha:0.4]
.
titleColor
- title color for UICustomActionSheet. The default value is whiteColor
subtitleColor
- subtitle color for UICustomActionSheet. The default value is lightGrayColor
buttonsTextColor
- button's text color for normal state . The default value is whiteColor
Title and subtitle font size
subtitle
- subtitle text. It doesn't effect if it's nil
subtitleFontSize
- float
value for subtitle text font size. The default value is 14.0
title
- main title text. It doesn't effect if it's nil
titleFontSize
- float
value for title text font size. The default value is 22.0
Background customization
blurredBackground
- bool
value. Set NO
if you don't want to blur UICustomActionSheet presenter view. The default value is YES
clearArea
- CGRect
value. Receives rect, which won't be blurred in case blurredBackground = YES
clearLayer: withCenter:
Example of using Use this method when you want to highlight some content while presenting UICustomActionSheet. Input parameters:
clearLayer
-CALayer
value. Receives a layer, that will be highlighted.withCenter
-CGPoint
value. Center point for provided layer in presenting view's coordinate system. This value will be used as a start value for the layer moving animation.
Example code:
- (void)showAlertForCell:(UITableViewCell *)cell {
UICustomActionSheet* actionSheet = [[UICustomActionSheet alloc] initWithTitle:"Title" delegate:nil buttonTitles:@[@"Cancel", @"OK"]];
[actionSheet setButtonColors:@[[UIColor redColor],[UIColor colorWithRed:0.0f green:153.0f/255.0f blue:0.0f alpha:1.0f]]];
[actionSheet setBackgroundColor:[UIColor clearColor]];
CGRect rect = [self.view convertRect:cell.frame fromView:_tableView];
[actionSheet clearLayer:cell.layer withCenter:CGPointMake(rect.origin.x + rect.size.width / 2.0f, rect.origin.y + rect.size.height / 2.0f)];
[actionSheet setSubtitle:@"Subtitle"];
[actionSheet setSubtitleColor:[UIColor whiteColor]];
[actionSheet showInView:self.view];
}
License
The MIT License (MIT)
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.