Close Menu

jgactionsheet

An ActionSheet is an iOS component that presents a list of options to the user. It is a drop-down menu style interface that is commonly used to provide a set of actions or choices in response to a user’s interaction with a button, a table cell, or any other view. JGActionSheet is a simple and customizable ActionSheet for iOS, written in Objective-C.

Installation

To use JGActionSheet in your project, follow these steps:

  1. Install the JGActionSheet library through Cocoapods by adding the following line to your Podfile:
    2. [code]pod 'JGActionSheet'[/code]
  2. Run the command pod install to install the library.
  3. Make sure to import the JGActionSheet header file in your class:
    4. [code]#import "JGActionSheet.h"[/code]
  4. You are now ready to use JGActionSheet in your project!

Usage

To present JGActionSheet, follow the steps below:

  1. Create an instance of JGActionSheet:
    2. [code]JGActionSheet *actionSheet = [[JGActionSheet alloc] initWithSectionTitles:@[@"Option 1", @"Option 2", @"Option 3"]];[/code]
  2. Set up any additional customization options:
    3. [code]actionSheet.title = @"Choose an option";
actionSheet.delegate = self;
[actionSheet setCancelButtonWithTitle:@"Cancel" onPress:nil];
[actionSheet setButtonBackgroundColor:[UIColor blackColor] textColor:[UIColor whiteColor] atIndex:0];[/code]
  3. In the above example, we set up a custom title, delegate, a cancel button, and customized background and text colors for the first option.
  4. Show the ActionSheet:
    5. [code][actionSheet showInView:self.view animated:YES];[/code]
  5. Handle the user’s selection with the delegate method didSelectSection:(NSUInteger)sectionIndex atIndex:(NSUInteger)itemIndex:
    6. [code]- (void)actionSheet:(JGActionSheet *)actionSheet didSelectSection:(NSUInteger)sectionIndex atIndex:(NSUInteger)itemIndex {
  // Handle the selection
}[/code]

Customization

JGActionSheet offers various customization options to tailor the appearance and behavior of the ActionSheet according to your needs.

  • Title: Set a custom title for the ActionSheet.
  • Delegate: Assign a delegate to handle the user’s selection.
  • Buttons: Customize the buttons, such as setting a cancel button, adding buttons with specific titles, or configuring their appearance individually.
  • Button Background Color: Set the background color of a button at a specific index.
  • Button Text Color: Set the text color of a button at a specific index.
  • Button Text Alignment: Align the button’s text to left, right, or center.
  • Animation: Enable or disable animation when presenting or dismissing the ActionSheet.
  • ActionSheet Style: Choose between light or dark style.

Examples

Here are a few examples of how to utilize JGActionSheet:

Example 1: Simple ActionSheet with Default Styling

[code]JGActionSheet *actionSheet = [[JGActionSheet alloc] initWithSectionTitles:@[@"Option 1", @"Option 2", @"Option 3"]];
[actionSheet showInView:self.view animated:YES];[/code]

In this example, we create a simple ActionSheet with three options and display it in the current view with default styling.

Example 2: Customized ActionSheet with Delegate

[code]JGActionSheet *actionSheet = [[JGActionSheet alloc] initWithSectionTitles:@[@"Option 1", @"Option 2", @"Option 3"]];
actionSheet.delegate = self;
[actionSheet setTitle:@"Choose an option"];
[actionSheet setCancelButtonWithTitle:@"Cancel" onPress:nil];
[actionSheet addIcon:[UIImage imageNamed:@"icon1.png"] title:@"Favorite"];
[actionSheet addIcon:[UIImage imageNamed:@"icon2.png"] title:@"Share"];
[actionSheet setButtonBackgroundColor:[UIColor blackColor] textColor:[UIColor whiteColor] atIndex:0];
[actionSheet setButtonBackgroundColor:[UIColor redColor] textColor:[UIColor whiteColor] atIndex:1];
[actionSheet setButtonAlignment:NSTextAlignmentCenter];
[actionSheet showInView:self.view animated:YES];[/code]

In this example, we create a customized ActionSheet with a title, a cancel button, and two additional options with icons. We also customize the background and text colors for the first two options and change the button’s text alignment to center. The `self` object is set as the delegate to handle the user’s selection.

Conclusion

JGActionSheet is a versatile and user-friendly ActionSheet library for iOS. With its easy installation and extensive customization options, you can quickly integrate ActionSheets into your app and provide a seamless user experience.

For more details and advanced customization options, refer to the official documentation and example projects provided with the JGActionSheet library.