Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nealyoung/NYAlertViewController
Highly configurable iOS Alert Views with custom content views
https://github.com/nealyoung/NYAlertViewController
Last synced: 3 months ago
JSON representation
Highly configurable iOS Alert Views with custom content views
- Host: GitHub
- URL: https://github.com/nealyoung/NYAlertViewController
- Owner: nealyoung
- License: mit
- Created: 2015-07-21T04:49:40.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-05-15T08:04:43.000Z (over 1 year ago)
- Last Synced: 2024-04-28T13:22:55.993Z (6 months ago)
- Language: Objective-C
- Homepage:
- Size: 22.8 MB
- Stars: 609
- Watchers: 21
- Forks: 107
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-ios - NYAlertViewController - Highly configurable iOS Alert Views with custom content views. (UI / Alert & Action Sheet)
- awesome-ios-star - NYAlertViewController - Highly configurable iOS Alert Views with custom content views. (UI / Alert & Action Sheet)
README
# NYAlertViewController
NYAlertViewController is a replacement for UIAlertController/UIAlertView with support for content views and UI customization.
### Features
* Includes content view property for adding custom views to the alert view
* Block-based API similar to UIAlertController/UIAlertAction
* Support for all screen orientations and iPad screen sizes
* Easily add text fields with simple API identical to UIAlertController
* Choose between fade (similar to UIAlertController) or slide transition animations
### Installation
#### Manual
Add the files to your project manually by dragging the NYAlertViewController directory into your Xcode project.
#### CocoaPods
Add `pod 'NYAlertViewController'` to your Podfile, and run `pod install`.
### Usage Example
An Objective-C example project demonstrating customization options is included in the NYAlertViewControllerDemo directory.
#### Objective-C
```objc
// Import the class and create an NYAlertViewController instance
#import "NYAlertViewController.h"
// ...
// Set a title and message
NSString *title = @"Location Permission";
NSString *message = @"Set the alertViewContentView property to add custom views to the alert view";
// Customize appearance as desired
NYAlertViewControllerConfiguration *configuration = [NYAlertViewControllerConfiguration new];
configuration.contentViewInset = UIEdgeInsetsMake(12.0f, 8.0f, 8.0f, 8.0f);
configuration.alertViewBackgroundColor = [UIColor colorWithRed:0.23f green:0.23f blue:0.27f alpha:1.0f];
configuration.separatorColor = [UIColor colorWithRed:0.16f green:0.16f blue:0.2f alpha:1.0f];
configuration.titleTextColor = [UIColor whiteColor];
configuration.messageTextColor = [UIColor whiteColor];
configuration.buttonConfiguration = [NYAlertActionConfiguration new];
configuration.buttonConfiguration.titleColor = [UIColor whiteColor];
configuration.cancelButtonConfiguration.titleColor = [UIColor whiteColor];
// Set up alert actions
NYAlertAction *cancelAction = [[NYAlertAction alloc] initWithTitle:@"Later"
style:UIAlertActionStyleCancel
handler:nil];
NYAlertAction *okAction = [[NYAlertAction alloc] initWithTitle:@"Ok"
style:UIAlertActionStyleDefault
handler:^(NYAlertAction *action) {
[self doSomething];
}]];
NYAlertViewController *alertViewController = [[NYAlertViewController alloc] initWithOptions:configuration
title:title
message:message
actions:@[cancelAction, okAction]];
// Optionally add a content view
UIImageView *iconImageView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"MapIcon"]];
iconImageView.contentMode = UIViewContentModeScaleAspectFit;
[iconImageView.heightAnchor constraintEqualToConstant:60.0f].active = YES;
alertViewController.alertViewContentView = iconImageView;
// Present the alert view controller
[self presentViewController:alertViewController animated:YES completion:nil];
```
### License
This project is released under the MIT License.