131 lines
4.4 KiB
Markdown
131 lines
4.4 KiB
Markdown
|
Toast for iOS
|
||
|
|
=============
|
||
|
|
|
||
|
|
[](https://travis-ci.org/scalessec/Toast)
|
||
|
|
[](http://cocoadocs.org/docsets/Toast)
|
||
|
|
[](https://github.com/Carthage/Carthage)
|
||
|
|
|
||
|
|
Toast is an Objective-C category that adds toast notifications to the `UIView` object class. It is intended to be simple, lightweight, and easy to use. Most
|
||
|
|
toast notifications can be triggered with a single line of code.
|
||
|
|
|
||
|
|
**Using Swift? A native swift port of this library is now available: [Toast-Swift](https://github.com/scalessec/Toast-Swift "Toast-Swift")**
|
||
|
|
|
||
|
|
Screenshots
|
||
|
|
---------
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Basic Examples
|
||
|
|
---------
|
||
|
|
```objc
|
||
|
|
// basic usage
|
||
|
|
[self.view makeToast:@"This is a piece of toast."];
|
||
|
|
|
||
|
|
// toast with a specific duration and position
|
||
|
|
[self.view makeToast:@"This is a piece of toast with a specific duration and position."
|
||
|
|
duration:3.0
|
||
|
|
position:CSToastPositionTop];
|
||
|
|
|
||
|
|
// toast with all possible options
|
||
|
|
[self.view makeToast:@"This is a piece of toast with a title & image"
|
||
|
|
duration:3.0
|
||
|
|
position:[NSValue valueWithCGPoint:CGPointMake(110, 110)]
|
||
|
|
title:@"Toast Title"
|
||
|
|
image:[UIImage imageNamed:@"toast.png"]
|
||
|
|
style:nil
|
||
|
|
completion:^(BOOL didTap) {
|
||
|
|
if (didTap) {
|
||
|
|
NSLog(@"completion from tap");
|
||
|
|
} else {
|
||
|
|
NSLog(@"completion without tap");
|
||
|
|
}
|
||
|
|
}];
|
||
|
|
|
||
|
|
// display toast with an activity spinner
|
||
|
|
[self.view makeToastActivity:CSToastPositionCenter];
|
||
|
|
|
||
|
|
// display any view as toast
|
||
|
|
[self.view showToast:myView];
|
||
|
|
```
|
||
|
|
|
||
|
|
But wait, there's more!
|
||
|
|
---------
|
||
|
|
```objc
|
||
|
|
// create a new style
|
||
|
|
CSToastStyle *style = [[CSToastStyle alloc] initWithDefaultStyle];
|
||
|
|
|
||
|
|
// this is just one of many style options
|
||
|
|
style.messageColor = [UIColor orangeColor];
|
||
|
|
|
||
|
|
// present the toast with the new style
|
||
|
|
[self.view makeToast:@"This is a piece of toast."
|
||
|
|
duration:3.0
|
||
|
|
position:CSToastPositionBottom
|
||
|
|
style:style];
|
||
|
|
|
||
|
|
// or perhaps you want to use this style for all toasts going forward?
|
||
|
|
// just set the shared style and there's no need to provide the style again
|
||
|
|
[CSToastManager setSharedStyle:style];
|
||
|
|
|
||
|
|
// toggle "tap to dismiss" functionality
|
||
|
|
[CSToastManager setTapToDismissEnabled:YES];
|
||
|
|
|
||
|
|
// toggle queueing behavior
|
||
|
|
[CSToastManager setQueueEnabled:YES];
|
||
|
|
|
||
|
|
// immediately hides all toast views in self.view
|
||
|
|
[self.view hideAllToasts];
|
||
|
|
```
|
||
|
|
|
||
|
|
See the demo project for more examples.
|
||
|
|
|
||
|
|
Setup Instructions
|
||
|
|
------------------
|
||
|
|
|
||
|
|
[CocoaPods](http://cocoapods.org)
|
||
|
|
------------------
|
||
|
|
|
||
|
|
Install with CocoaPods by adding the following to your `Podfile`:
|
||
|
|
```ruby
|
||
|
|
pod 'Toast', '~> 4.0.0'
|
||
|
|
```
|
||
|
|
|
||
|
|
[Carthage](https://github.com/Carthage/Carthage)
|
||
|
|
------------------
|
||
|
|
|
||
|
|
Install with Carthage by adding the following to your `Cartfile`:
|
||
|
|
```ogdl
|
||
|
|
github "scalessec/Toast" ~> 4.0.0
|
||
|
|
```
|
||
|
|
Run `carthage update` to build the framework and link against `Toast.framework`. Then, `#import <Toast/Toast.h>`.
|
||
|
|
|
||
|
|
Manually
|
||
|
|
--------
|
||
|
|
|
||
|
|
1. Add `UIView+Toast.h` & `UIView+Toast.m` to your project.
|
||
|
|
2. `#import "UIView+Toast.h"`
|
||
|
|
3. Grab yourself a cold 🍺.
|
||
|
|
|
||
|
|
MIT License
|
||
|
|
-----------
|
||
|
|
Copyright (c) 2011-2017 Charles Scalesse.
|
||
|
|
|
||
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
||
|
|
copy of this software and associated documentation files (the
|
||
|
|
"Software"), to deal in the Software without restriction, including
|
||
|
|
without limitation the rights to use, copy, modify, merge, publish,
|
||
|
|
distribute, sublicense, and/or sell copies of the Software, and to
|
||
|
|
permit persons to whom the Software is furnished to do so, subject to
|
||
|
|
the following conditions:
|
||
|
|
|
||
|
|
The above copyright notice and this permission notice shall be included
|
||
|
|
in all copies or substantial portions of the Software.
|
||
|
|
|
||
|
|
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.
|