Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wimagguc/ios-custom-alertview
Custom UIAlertView. Continue adding images and UIViews to dialogs in iOS7+
https://github.com/wimagguc/ios-custom-alertview
Last synced: 6 days ago
JSON representation
Custom UIAlertView. Continue adding images and UIViews to dialogs in iOS7+
- Host: GitHub
- URL: https://github.com/wimagguc/ios-custom-alertview
- Owner: wimagguc
- License: other
- Created: 2013-09-20T10:53:47.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2019-12-26T21:32:02.000Z (about 5 years ago)
- Last Synced: 2025-02-08T07:03:38.992Z (13 days ago)
- Language: Objective-C
- Homepage:
- Size: 250 KB
- Stars: 1,657
- Watchers: 65
- Forks: 394
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Custom iOS AlertView
`v0.9.5`
`support for iOS7+`
The addSubview is not available in UIAlertView since iOS7. The view hierarchy for this class is private and must not be modified.
As a solution, this class creates an iOS-style dialog which you can extend with any UIViews or buttons. The animations and the looks are copied too and no images or other resources are needed.
## Install
As simple as adding the following files to your project:
* CustomIOSAlertView.h
* CustomIOSAlertView.m
Or use Cocoapods:
```
pod 'CustomIOSAlertView', '~> 0.9.5'
```
## Change notes
* Fixed rotation for IOS8
* Removed 7 from the class name. Just use CustomIOSAlertView from now on, like: [[CustomIOSAlertView alloc] init];
* The initWithParentView method is now deprecated. Please use the init method instead, where you don't need to pass a parent view at all. **In case the init doesn't work for you, please leave a note or open an issue here.**
## Quick start guide
1. Create the UIView object `changed`
```
CustomIOSAlertView *alertView = [[CustomIOSAlertView alloc] init];
```
2. Add some custom content to the alert view (optional)
```
UIView *customView ..;
[alertView setContainerView:customView];
```
3. Display the dialog
```
[alertView show];
```
## More functions
* Close the dialog
```
[alertView close];
```
* To add more buttons, pass a list of titles
```
[alertView setButtonTitles:[NSMutableArray arrayWithObjects:@"Button1", @"Button2", @"Button3", nil]];
```
* You can remove all buttons by passing nil
```
[alertView setButtonTitles:NULL];
```
* You can enable or disable the iOS7 parallax effects on the alert view
```
[alertView setUseMotionEffects:TRUE];
```
* Handle button clicks with a custom delegate
First, set the delegate:
```
[alertView setDelegate:self];
```
Then add the delegate methods:
```
- (void)customIOS7dialogButtonTouchUpInside: (CustomIOSAlertView *)alertView clickedButtonAtIndex: (NSInteger)buttonIndex
{
NSLog(@"Button at position %d is clicked on alertView %d.", buttonIndex, [alertView tag]);
}
```
* Handle button clicks with a code block
```
[alertView setOnButtonTouchUpInside:^(CustomIOSAlertView *alertView, int buttonIndex) {
NSLog(@"Block: Button at position %d is clicked on alertView %d.", buttonIndex, [alertView tag]);
[alertView close];
}];
```
You can also disable all other delegates by:
```
[alertView setDelegate:self];
```
## Todos
This is a really quick implementation, and there are a few things missing:
* Adding more buttons: they don't exactly match the look with that of on iOS7
* Rotation: rotates wrong with the keyboard on
## Special thanks to
* [@tamasdancsi](https://github.com/tamasdancsi) for his support with the initial code
* [@dingosky](https://github.com/dingosky) for his work on the parallax effects code
* [@raspu](https://github.com/raspu) for his work on the protocol delegates, iOS6 support and onButtonClick blocks
* [@sbandol](https://github.com/sbandol) for his idea on adding the AlertView as the top most view in the hierarchy
* [@scorpiozj](https://github.com/scorpiozj) for his work on the rotation code
* [@kwent](https://github.com/kwent) for adding performance optimisations
* [@thomasaw](https://github.com/thomasaw) for the refract on the deprecated initWithParentview
* [@yiboyu](https://github.com/yiboyu) for the multi-line button fix
* [@logicxd](https://github.com/logicxd) for the close-on-touchup-outside code
## License
MIT. Please read [LICENSE.md](https://github.com/wimagguc/ios-custom-alertview/blob/master/LICENSE.md) for more info.
## Other projects
Check out [Appwoodoo](http://www.appwoodoo.com/) for push notifications and remote app control service. Open source SDKs are available on Github: [github.com/appwoodoo](https://github.com/appwoodoo?tab=repositories).
Some more of my free stuff for web devs at [Github](https://github.com/wimagguc?tab=repositories).
Project updates [newsletter](http://wimagguc.us4.list-manage.com/subscribe/post?u=83343dbd708d35d76618f66c5&id=da7cc7f1dc)
## About
Richard Dancsi
[www.wimagguc.com](http://www.wimagguc.com/)
twitter: [@wimagguc](http://twitter.com/wimagguc)
linkedin: [linkedin.com/in/richarddancsi](http://linkedin.com/in/richarddancsi)