| Pods/Pods.xcodeproj/xcuserdata/mj.xcuserdatad/xcschemes/Toast.xcscheme | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Target Support Files/Toast/Info.plist | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Target Support Files/Toast/Toast-dummy.m | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Target Support Files/Toast/Toast-prefix.pch | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Target Support Files/Toast/Toast-umbrella.h | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Target Support Files/Toast/Toast.modulemap | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Target Support Files/Toast/Toast.xcconfig | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Toast/README.md | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Toast/Toast-Framework/Toast.h | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Toast/Toast/UIView+Toast.h | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Toast/Toast/UIView+Toast.m | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| Pods/Toast/license | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 |
Pods/Pods.xcodeproj/xcuserdata/mj.xcuserdatad/xcschemes/Toast.xcscheme
New file @@ -0,0 +1,60 @@ <?xml version="1.0" encoding="UTF-8"?> <Scheme LastUpgradeVersion = "0930" version = "1.3"> <BuildAction parallelizeBuildables = "YES" buildImplicitDependencies = "YES"> <BuildActionEntries> <BuildActionEntry buildForAnalyzing = "YES" buildForTesting = "YES" buildForRunning = "YES" buildForProfiling = "YES" buildForArchiving = "YES"> <BuildableReference BuildableIdentifier = "primary" BlueprintIdentifier = "6BB2F495E7512C2D6C4657497F2DD75B" BlueprintName = "Toast" ReferencedContainer = "container:Pods.xcodeproj" BuildableName = "Toast.framework"> </BuildableReference> </BuildActionEntry> </BuildActionEntries> </BuildAction> <TestAction selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB" selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB" shouldUseLaunchSchemeArgsEnv = "YES" buildConfiguration = "Debug"> <AdditionalOptions> </AdditionalOptions> </TestAction> <LaunchAction selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB" selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB" launchStyle = "0" useCustomWorkingDirectory = "NO" ignoresPersistentStateOnLaunch = "NO" debugDocumentVersioning = "YES" debugServiceExtension = "internal" buildConfiguration = "Debug" allowLocationSimulation = "YES"> <AdditionalOptions> </AdditionalOptions> </LaunchAction> <ProfileAction savedToolIdentifier = "" useCustomWorkingDirectory = "NO" debugDocumentVersioning = "YES" buildConfiguration = "Release" shouldUseLaunchSchemeArgsEnv = "YES"> </ProfileAction> <AnalyzeAction buildConfiguration = "Debug"> </AnalyzeAction> <ArchiveAction buildConfiguration = "Release" revealArchiveInOrganizer = "YES"> </ArchiveAction> </Scheme> Pods/Target Support Files/Toast/Info.plist
New file @@ -0,0 +1,26 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>CFBundleDevelopmentRegion</key> <string>en</string> <key>CFBundleExecutable</key> <string>${EXECUTABLE_NAME}</string> <key>CFBundleIdentifier</key> <string>${PRODUCT_BUNDLE_IDENTIFIER}</string> <key>CFBundleInfoDictionaryVersion</key> <string>6.0</string> <key>CFBundleName</key> <string>${PRODUCT_NAME}</string> <key>CFBundlePackageType</key> <string>FMWK</string> <key>CFBundleShortVersionString</key> <string>4.0.0</string> <key>CFBundleSignature</key> <string>????</string> <key>CFBundleVersion</key> <string>${CURRENT_PROJECT_VERSION}</string> <key>NSPrincipalClass</key> <string></string> </dict> </plist> Pods/Target Support Files/Toast/Toast-dummy.m
New file @@ -0,0 +1,5 @@ #import <Foundation/Foundation.h> @interface PodsDummy_Toast : NSObject @end @implementation PodsDummy_Toast @end Pods/Target Support Files/Toast/Toast-prefix.pch
New file @@ -0,0 +1,12 @@ #ifdef __OBJC__ #import <UIKit/UIKit.h> #else #ifndef FOUNDATION_EXPORT #if defined(__cplusplus) #define FOUNDATION_EXPORT extern "C" #else #define FOUNDATION_EXPORT extern #endif #endif #endif
New file @@ -0,0 +1,18 @@ #ifdef __OBJC__ #import <UIKit/UIKit.h> #else #ifndef FOUNDATION_EXPORT #if defined(__cplusplus) #define FOUNDATION_EXPORT extern "C" #else #define FOUNDATION_EXPORT extern #endif #endif #endif #import "UIView+Toast.h" #import "Toast.h" FOUNDATION_EXPORT double ToastVersionNumber; FOUNDATION_EXPORT const unsigned char ToastVersionString[];
New file @@ -0,0 +1,6 @@ framework module Toast { umbrella header "Toast-umbrella.h" export * module * { export * } } Pods/Target Support Files/Toast/Toast.xcconfig
New file @@ -0,0 +1,9 @@ CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/Toast GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 OTHER_LDFLAGS = -framework "QuartzCore" PODS_BUILD_DIR = ${BUILD_DIR} PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) PODS_ROOT = ${SRCROOT} PODS_TARGET_SRCROOT = ${PODS_ROOT}/Toast PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} SKIP_INSTALL = YES Pods/Toast/README.md
New file @@ -0,0 +1,130 @@ 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. Pods/Toast/Toast-Framework/Toast.h
New file @@ -0,0 +1,18 @@ // // Toast.h // Toast // // Created by Charles Scalesse on 11/3/16. // // #import <UIKit/UIKit.h> //! Project version number for Toast. FOUNDATION_EXPORT double ToastVersionNumber; //! Project version string for Toast. FOUNDATION_EXPORT const unsigned char ToastVersionString[]; // In this header, you should import all the public headers of your framework using statements like #import <Toast/PublicHeader.h> #import <Toast/UIView+Toast.h> Pods/Toast/Toast/UIView+Toast.h
New file @@ -0,0 +1,446 @@ // // UIView+Toast.h // Toast // // 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. #import <UIKit/UIKit.h> extern const NSString * CSToastPositionTop; extern const NSString * CSToastPositionCenter; extern const NSString * CSToastPositionBottom; @class CSToastStyle; /** 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. The `makeToast:` methods create a new view and then display it as toast. The `showToast:` methods display any view as toast. */ @interface UIView (Toast) /** Creates and presents a new toast view with a message and displays it with the default duration and position. Styled using the shared style. @param message The message to be displayed */ - (void)makeToast:(NSString *)message; /** Creates and presents a new toast view with a message. Duration and position can be set explicitly. Styled using the shared style. @param message The message to be displayed @param duration The toast duration @param position The toast's center point. Can be one of the predefined CSToastPosition constants or a `CGPoint` wrapped in an `NSValue` object. */ - (void)makeToast:(NSString *)message duration:(NSTimeInterval)duration position:(id)position; /** Creates and presents a new toast view with a message. Duration, position, and style can be set explicitly. @param message The message to be displayed @param duration The toast duration @param position The toast's center point. Can be one of the predefined CSToastPosition constants or a `CGPoint` wrapped in an `NSValue` object. @param style The style. The shared style will be used when nil */ - (void)makeToast:(NSString *)message duration:(NSTimeInterval)duration position:(id)position style:(CSToastStyle *)style; /** Creates and presents a new toast view with a message, title, and image. Duration, position, and style can be set explicitly. The completion block executes when the toast view completes. `didTap` will be `YES` if the toast view was dismissed from a tap. @param message The message to be displayed @param duration The toast duration @param position The toast's center point. Can be one of the predefined CSToastPosition constants or a `CGPoint` wrapped in an `NSValue` object. @param title The title @param image The image @param style The style. The shared style will be used when nil @param completion The completion block, executed after the toast view disappears. didTap will be `YES` if the toast view was dismissed from a tap. */ - (void)makeToast:(NSString *)message duration:(NSTimeInterval)duration position:(id)position title:(NSString *)title image:(UIImage *)image style:(CSToastStyle *)style completion:(void(^)(BOOL didTap))completion; /** Creates a new toast view with any combination of message, title, and image. The look and feel is configured via the style. Unlike the `makeToast:` methods, this method does not present the toast view automatically. One of the showToast: methods must be used to present the resulting view. @warning if message, title, and image are all nil, this method will return nil. @param message The message to be displayed @param title The title @param image The image @param style The style. The shared style will be used when nil @return The newly created toast view */ - (UIView *)toastViewForMessage:(NSString *)message title:(NSString *)title image:(UIImage *)image style:(CSToastStyle *)style; /** Hides the active toast. If there are multiple toasts active in a view, this method hides the oldest toast (the first of the toasts to have been presented). @see `hideAllToasts` to remove all active toasts from a view. @warning This method has no effect on activity toasts. Use `hideToastActivity` to hide activity toasts. */ - (void)hideToast; /** Hides an active toast. @param toast The active toast view to dismiss. Any toast that is currently being displayed on the screen is considered active. @warning this does not clear a toast view that is currently waiting in the queue. */ - (void)hideToast:(UIView *)toast; /** Hides all active toast views and clears the queue. */ - (void)hideAllToasts; /** Hides all active toast views, with options to hide activity and clear the queue. @param includeActivity If `true`, toast activity will also be hidden. Default is `false`. @param clearQueue If `true`, removes all toast views from the queue. Default is `true`. */ - (void)hideAllToasts:(BOOL)includeActivity clearQueue:(BOOL)clearQueue; /** Removes all toast views from the queue. This has no effect on toast views that are active. Use `hideAllToasts` to hide the active toasts views and clear the queue. */ - (void)clearToastQueue; /** Creates and displays a new toast activity indicator view at a specified position. @warning Only one toast activity indicator view can be presented per superview. Subsequent calls to `makeToastActivity:` will be ignored until hideToastActivity is called. @warning `makeToastActivity:` works independently of the showToast: methods. Toast activity views can be presented and dismissed while toast views are being displayed. `makeToastActivity:` has no effect on the queueing behavior of the showToast: methods. @param position The toast's center point. Can be one of the predefined CSToastPosition constants or a `CGPoint` wrapped in an `NSValue` object. */ - (void)makeToastActivity:(id)position; /** Dismisses the active toast activity indicator view. */ - (void)hideToastActivity; /** Displays any view as toast using the default duration and position. @param toast The view to be displayed as toast */ - (void)showToast:(UIView *)toast; /** Displays any view as toast at a provided position and duration. The completion block executes when the toast view completes. `didTap` will be `YES` if the toast view was dismissed from a tap. @param toast The view to be displayed as toast @param duration The notification duration @param position The toast's center point. Can be one of the predefined CSToastPosition constants or a `CGPoint` wrapped in an `NSValue` object. @param completion The completion block, executed after the toast view disappears. didTap will be `YES` if the toast view was dismissed from a tap. */ - (void)showToast:(UIView *)toast duration:(NSTimeInterval)duration position:(id)position completion:(void(^)(BOOL didTap))completion; @end /** `CSToastStyle` instances define the look and feel for toast views created via the `makeToast:` methods as well for toast views created directly with `toastViewForMessage:title:image:style:`. @warning `CSToastStyle` offers relatively simple styling options for the default toast view. If you require a toast view with more complex UI, it probably makes more sense to create your own custom UIView subclass and present it with the `showToast:` methods. */ @interface CSToastStyle : NSObject /** The background color. Default is `[UIColor blackColor]` at 80% opacity. */ @property (strong, nonatomic) UIColor *backgroundColor; /** The title color. Default is `[UIColor whiteColor]`. */ @property (strong, nonatomic) UIColor *titleColor; /** The message color. Default is `[UIColor whiteColor]`. */ @property (strong, nonatomic) UIColor *messageColor; /** A percentage value from 0.0 to 1.0, representing the maximum width of the toast view relative to it's superview. Default is 0.8 (80% of the superview's width). */ @property (assign, nonatomic) CGFloat maxWidthPercentage; /** A percentage value from 0.0 to 1.0, representing the maximum height of the toast view relative to it's superview. Default is 0.8 (80% of the superview's height). */ @property (assign, nonatomic) CGFloat maxHeightPercentage; /** The spacing from the horizontal edge of the toast view to the content. When an image is present, this is also used as the padding between the image and the text. Default is 10.0. */ @property (assign, nonatomic) CGFloat horizontalPadding; /** The spacing from the vertical edge of the toast view to the content. When a title is present, this is also used as the padding between the title and the message. Default is 10.0. */ @property (assign, nonatomic) CGFloat verticalPadding; /** The corner radius. Default is 10.0. */ @property (assign, nonatomic) CGFloat cornerRadius; /** The title font. Default is `[UIFont boldSystemFontOfSize:16.0]`. */ @property (strong, nonatomic) UIFont *titleFont; /** The message font. Default is `[UIFont systemFontOfSize:16.0]`. */ @property (strong, nonatomic) UIFont *messageFont; /** The title text alignment. Default is `NSTextAlignmentLeft`. */ @property (assign, nonatomic) NSTextAlignment titleAlignment; /** The message text alignment. Default is `NSTextAlignmentLeft`. */ @property (assign, nonatomic) NSTextAlignment messageAlignment; /** The maximum number of lines for the title. The default is 0 (no limit). */ @property (assign, nonatomic) NSInteger titleNumberOfLines; /** The maximum number of lines for the message. The default is 0 (no limit). */ @property (assign, nonatomic) NSInteger messageNumberOfLines; /** Enable or disable a shadow on the toast view. Default is `NO`. */ @property (assign, nonatomic) BOOL displayShadow; /** The shadow color. Default is `[UIColor blackColor]`. */ @property (strong, nonatomic) UIColor *shadowColor; /** A value from 0.0 to 1.0, representing the opacity of the shadow. Default is 0.8 (80% opacity). */ @property (assign, nonatomic) CGFloat shadowOpacity; /** The shadow radius. Default is 6.0. */ @property (assign, nonatomic) CGFloat shadowRadius; /** The shadow offset. The default is `CGSizeMake(4.0, 4.0)`. */ @property (assign, nonatomic) CGSize shadowOffset; /** The image size. The default is `CGSizeMake(80.0, 80.0)`. */ @property (assign, nonatomic) CGSize imageSize; /** The size of the toast activity view when `makeToastActivity:` is called. Default is `CGSizeMake(100.0, 100.0)`. */ @property (assign, nonatomic) CGSize activitySize; /** The fade in/out animation duration. Default is 0.2. */ @property (assign, nonatomic) NSTimeInterval fadeDuration; /** Creates a new instance of `CSToastStyle` with all the default values set. */ - (instancetype)initWithDefaultStyle NS_DESIGNATED_INITIALIZER; /** @warning Only the designated initializer should be used to create an instance of `CSToastStyle`. */ - (instancetype)init NS_UNAVAILABLE; @end /** `CSToastManager` provides general configuration options for all toast notifications. Backed by a singleton instance. */ @interface CSToastManager : NSObject /** Sets the shared style on the singleton. The shared style is used whenever a `makeToast:` method (or `toastViewForMessage:title:image:style:`) is called with with a nil style. By default, this is set to `CSToastStyle`'s default style. @param sharedStyle the shared style */ + (void)setSharedStyle:(CSToastStyle *)sharedStyle; /** Gets the shared style from the singlton. By default, this is `CSToastStyle`'s default style. @return the shared style */ + (CSToastStyle *)sharedStyle; /** Enables or disables tap to dismiss on toast views. Default is `YES`. @param tapToDismissEnabled YES or NO */ + (void)setTapToDismissEnabled:(BOOL)tapToDismissEnabled; /** Returns `YES` if tap to dismiss is enabled, otherwise `NO`. Default is `YES`. @return BOOL YES or NO */ + (BOOL)isTapToDismissEnabled; /** Enables or disables queueing behavior for toast views. When `YES`, toast views will appear one after the other. When `NO`, multiple Toast views will appear at the same time (potentially overlapping depending on their positions). This has no effect on the toast activity view, which operates independently of normal toast views. Default is `NO`. @param queueEnabled YES or NO */ + (void)setQueueEnabled:(BOOL)queueEnabled; /** Returns `YES` if the queue is enabled, otherwise `NO`. Default is `NO`. @return BOOL */ + (BOOL)isQueueEnabled; /** Sets the default duration. Used for the `makeToast:` and `showToast:` methods that don't require an explicit duration. Default is 3.0. @param duration The toast duration */ + (void)setDefaultDuration:(NSTimeInterval)duration; /** Returns the default duration. Default is 3.0. @return duration The toast duration */ + (NSTimeInterval)defaultDuration; /** Sets the default position. Used for the `makeToast:` and `showToast:` methods that don't require an explicit position. Default is `CSToastPositionBottom`. @param position The default center point. Can be one of the predefined CSToastPosition constants or a `CGPoint` wrapped in an `NSValue` object. */ + (void)setDefaultPosition:(id)position; /** Returns the default toast position. Default is `CSToastPositionBottom`. @return position The default center point. Will be one of the predefined CSToastPosition constants or a `CGPoint` wrapped in an `NSValue` object. */ + (id)defaultPosition; @end Pods/Toast/Toast/UIView+Toast.m
New file @@ -0,0 +1,586 @@ // // UIView+Toast.m // Toast // // 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. #import "UIView+Toast.h" #import <QuartzCore/QuartzCore.h> #import <objc/runtime.h> // Positions NSString * CSToastPositionTop = @"CSToastPositionTop"; NSString * CSToastPositionCenter = @"CSToastPositionCenter"; NSString * CSToastPositionBottom = @"CSToastPositionBottom"; // Keys for values associated with toast views static const NSString * CSToastTimerKey = @"CSToastTimerKey"; static const NSString * CSToastDurationKey = @"CSToastDurationKey"; static const NSString * CSToastPositionKey = @"CSToastPositionKey"; static const NSString * CSToastCompletionKey = @"CSToastCompletionKey"; // Keys for values associated with self static const NSString * CSToastActiveKey = @"CSToastActiveKey"; static const NSString * CSToastActivityViewKey = @"CSToastActivityViewKey"; static const NSString * CSToastQueueKey = @"CSToastQueueKey"; @interface UIView (ToastPrivate) /** These private methods are being prefixed with "cs_" to reduce the likelihood of non-obvious naming conflicts with other UIView methods. @discussion Should the public API also use the cs_ prefix? Technically it should, but it results in code that is less legible. The current public method names seem unlikely to cause conflicts so I think we should favor the cleaner API for now. */ - (void)cs_showToast:(UIView *)toast duration:(NSTimeInterval)duration position:(id)position; - (void)cs_hideToast:(UIView *)toast; - (void)cs_hideToast:(UIView *)toast fromTap:(BOOL)fromTap; - (void)cs_toastTimerDidFinish:(NSTimer *)timer; - (void)cs_handleToastTapped:(UITapGestureRecognizer *)recognizer; - (CGPoint)cs_centerPointForPosition:(id)position withToast:(UIView *)toast; - (NSMutableArray *)cs_toastQueue; @end @implementation UIView (Toast) #pragma mark - Make Toast Methods - (void)makeToast:(NSString *)message { [self makeToast:message duration:[CSToastManager defaultDuration] position:[CSToastManager defaultPosition] style:nil]; } - (void)makeToast:(NSString *)message duration:(NSTimeInterval)duration position:(id)position { [self makeToast:message duration:duration position:position style:nil]; } - (void)makeToast:(NSString *)message duration:(NSTimeInterval)duration position:(id)position style:(CSToastStyle *)style { UIView *toast = [self toastViewForMessage:message title:nil image:nil style:style]; [self showToast:toast duration:duration position:position completion:nil]; } - (void)makeToast:(NSString *)message duration:(NSTimeInterval)duration position:(id)position title:(NSString *)title image:(UIImage *)image style:(CSToastStyle *)style completion:(void(^)(BOOL didTap))completion { UIView *toast = [self toastViewForMessage:message title:title image:image style:style]; [self showToast:toast duration:duration position:position completion:completion]; } #pragma mark - Show Toast Methods - (void)showToast:(UIView *)toast { [self showToast:toast duration:[CSToastManager defaultDuration] position:[CSToastManager defaultPosition] completion:nil]; } - (void)showToast:(UIView *)toast duration:(NSTimeInterval)duration position:(id)position completion:(void(^)(BOOL didTap))completion { // sanity if (toast == nil) return; // store the completion block on the toast view objc_setAssociatedObject(toast, &CSToastCompletionKey, completion, OBJC_ASSOCIATION_RETAIN_NONATOMIC); if ([CSToastManager isQueueEnabled] && [self.cs_activeToasts count] > 0) { // we're about to queue this toast view so we need to store the duration and position as well objc_setAssociatedObject(toast, &CSToastDurationKey, @(duration), OBJC_ASSOCIATION_RETAIN_NONATOMIC); objc_setAssociatedObject(toast, &CSToastPositionKey, position, OBJC_ASSOCIATION_RETAIN_NONATOMIC); // enqueue [self.cs_toastQueue addObject:toast]; } else { // present [self cs_showToast:toast duration:duration position:position]; } } #pragma mark - Hide Toast Methods - (void)hideToast { [self hideToast:[[self cs_activeToasts] firstObject]]; } - (void)hideToast:(UIView *)toast { // sanity if (!toast || ![[self cs_activeToasts] containsObject:toast]) return; [self cs_hideToast:toast]; } - (void)hideAllToasts { [self hideAllToasts:NO clearQueue:YES]; } - (void)hideAllToasts:(BOOL)includeActivity clearQueue:(BOOL)clearQueue { if (clearQueue) { [self clearToastQueue]; } for (UIView *toast in [self cs_activeToasts]) { [self hideToast:toast]; } if (includeActivity) { [self hideToastActivity]; } } - (void)clearToastQueue { [[self cs_toastQueue] removeAllObjects]; } #pragma mark - Private Show/Hide Methods - (void)cs_showToast:(UIView *)toast duration:(NSTimeInterval)duration position:(id)position { toast.center = [self cs_centerPointForPosition:position withToast:toast]; toast.alpha = 0.0; if ([CSToastManager isTapToDismissEnabled]) { UITapGestureRecognizer *recognizer = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(cs_handleToastTapped:)]; [toast addGestureRecognizer:recognizer]; toast.userInteractionEnabled = YES; toast.exclusiveTouch = YES; } [[self cs_activeToasts] addObject:toast]; [self addSubview:toast]; [UIView animateWithDuration:[[CSToastManager sharedStyle] fadeDuration] delay:0.0 options:(UIViewAnimationOptionCurveEaseOut | UIViewAnimationOptionAllowUserInteraction) animations:^{ toast.alpha = 1.0; } completion:^(BOOL finished) { NSTimer *timer = [NSTimer timerWithTimeInterval:duration target:self selector:@selector(cs_toastTimerDidFinish:) userInfo:toast repeats:NO]; [[NSRunLoop mainRunLoop] addTimer:timer forMode:NSRunLoopCommonModes]; objc_setAssociatedObject(toast, &CSToastTimerKey, timer, OBJC_ASSOCIATION_RETAIN_NONATOMIC); }]; } - (void)cs_hideToast:(UIView *)toast { [self cs_hideToast:toast fromTap:NO]; } - (void)cs_hideToast:(UIView *)toast fromTap:(BOOL)fromTap { NSTimer *timer = (NSTimer *)objc_getAssociatedObject(toast, &CSToastTimerKey); [timer invalidate]; [UIView animateWithDuration:[[CSToastManager sharedStyle] fadeDuration] delay:0.0 options:(UIViewAnimationOptionCurveEaseIn | UIViewAnimationOptionBeginFromCurrentState) animations:^{ toast.alpha = 0.0; } completion:^(BOOL finished) { [toast removeFromSuperview]; // remove [[self cs_activeToasts] removeObject:toast]; // execute the completion block, if necessary void (^completion)(BOOL didTap) = objc_getAssociatedObject(toast, &CSToastCompletionKey); if (completion) { completion(fromTap); } if ([self.cs_toastQueue count] > 0) { // dequeue UIView *nextToast = [[self cs_toastQueue] firstObject]; [[self cs_toastQueue] removeObjectAtIndex:0]; // present the next toast NSTimeInterval duration = [objc_getAssociatedObject(nextToast, &CSToastDurationKey) doubleValue]; id position = objc_getAssociatedObject(nextToast, &CSToastPositionKey); [self cs_showToast:nextToast duration:duration position:position]; } }]; } #pragma mark - View Construction - (UIView *)toastViewForMessage:(NSString *)message title:(NSString *)title image:(UIImage *)image style:(CSToastStyle *)style { // sanity if (message == nil && title == nil && image == nil) return nil; // default to the shared style if (style == nil) { style = [CSToastManager sharedStyle]; } // dynamically build a toast view with any combination of message, title, & image UILabel *messageLabel = nil; UILabel *titleLabel = nil; UIImageView *imageView = nil; UIView *wrapperView = [[UIView alloc] init]; wrapperView.autoresizingMask = (UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleRightMargin | UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleBottomMargin); wrapperView.layer.cornerRadius = style.cornerRadius; if (style.displayShadow) { wrapperView.layer.shadowColor = style.shadowColor.CGColor; wrapperView.layer.shadowOpacity = style.shadowOpacity; wrapperView.layer.shadowRadius = style.shadowRadius; wrapperView.layer.shadowOffset = style.shadowOffset; } wrapperView.backgroundColor = style.backgroundColor; if(image != nil) { imageView = [[UIImageView alloc] initWithImage:image]; imageView.contentMode = UIViewContentModeScaleAspectFit; imageView.frame = CGRectMake(style.horizontalPadding, style.verticalPadding, style.imageSize.width, style.imageSize.height); } CGRect imageRect = CGRectZero; if(imageView != nil) { imageRect.origin.x = style.horizontalPadding; imageRect.origin.y = style.verticalPadding; imageRect.size.width = imageView.bounds.size.width; imageRect.size.height = imageView.bounds.size.height; } if (title != nil) { titleLabel = [[UILabel alloc] init]; titleLabel.numberOfLines = style.titleNumberOfLines; titleLabel.font = style.titleFont; titleLabel.textAlignment = style.titleAlignment; titleLabel.lineBreakMode = NSLineBreakByTruncatingTail; titleLabel.textColor = style.titleColor; titleLabel.backgroundColor = [UIColor clearColor]; titleLabel.alpha = 1.0; titleLabel.text = title; // size the title label according to the length of the text CGSize maxSizeTitle = CGSizeMake((self.bounds.size.width * style.maxWidthPercentage) - imageRect.size.width, self.bounds.size.height * style.maxHeightPercentage); CGSize expectedSizeTitle = [titleLabel sizeThatFits:maxSizeTitle]; // UILabel can return a size larger than the max size when the number of lines is 1 expectedSizeTitle = CGSizeMake(MIN(maxSizeTitle.width, expectedSizeTitle.width), MIN(maxSizeTitle.height, expectedSizeTitle.height)); titleLabel.frame = CGRectMake(0.0, 0.0, expectedSizeTitle.width, expectedSizeTitle.height); } if (message != nil) { messageLabel = [[UILabel alloc] init]; messageLabel.numberOfLines = style.messageNumberOfLines; messageLabel.font = style.messageFont; messageLabel.textAlignment = style.messageAlignment; messageLabel.lineBreakMode = NSLineBreakByTruncatingTail; messageLabel.textColor = style.messageColor; messageLabel.backgroundColor = [UIColor clearColor]; messageLabel.alpha = 1.0; messageLabel.text = message; CGSize maxSizeMessage = CGSizeMake((self.bounds.size.width * style.maxWidthPercentage) - imageRect.size.width, self.bounds.size.height * style.maxHeightPercentage); CGSize expectedSizeMessage = [messageLabel sizeThatFits:maxSizeMessage]; // UILabel can return a size larger than the max size when the number of lines is 1 expectedSizeMessage = CGSizeMake(MIN(maxSizeMessage.width, expectedSizeMessage.width), MIN(maxSizeMessage.height, expectedSizeMessage.height)); messageLabel.frame = CGRectMake(0.0, 0.0, expectedSizeMessage.width, expectedSizeMessage.height); } CGRect titleRect = CGRectZero; if(titleLabel != nil) { titleRect.origin.x = imageRect.origin.x + imageRect.size.width + style.horizontalPadding; titleRect.origin.y = style.verticalPadding; titleRect.size.width = titleLabel.bounds.size.width; titleRect.size.height = titleLabel.bounds.size.height; } CGRect messageRect = CGRectZero; if(messageLabel != nil) { messageRect.origin.x = imageRect.origin.x + imageRect.size.width + style.horizontalPadding; messageRect.origin.y = titleRect.origin.y + titleRect.size.height + style.verticalPadding; messageRect.size.width = messageLabel.bounds.size.width; messageRect.size.height = messageLabel.bounds.size.height; } CGFloat longerWidth = MAX(titleRect.size.width, messageRect.size.width); CGFloat longerX = MAX(titleRect.origin.x, messageRect.origin.x); // Wrapper width uses the longerWidth or the image width, whatever is larger. Same logic applies to the wrapper height. CGFloat wrapperWidth = MAX((imageRect.size.width + (style.horizontalPadding * 2.0)), (longerX + longerWidth + style.horizontalPadding)); CGFloat wrapperHeight = MAX((messageRect.origin.y + messageRect.size.height + style.verticalPadding), (imageRect.size.height + (style.verticalPadding * 2.0))); wrapperView.frame = CGRectMake(0.0, 0.0, wrapperWidth, wrapperHeight); if(titleLabel != nil) { titleLabel.frame = titleRect; [wrapperView addSubview:titleLabel]; } if(messageLabel != nil) { messageLabel.frame = messageRect; [wrapperView addSubview:messageLabel]; } if(imageView != nil) { [wrapperView addSubview:imageView]; } return wrapperView; } #pragma mark - Storage - (NSMutableArray *)cs_activeToasts { NSMutableArray *cs_activeToasts = objc_getAssociatedObject(self, &CSToastActiveKey); if (cs_activeToasts == nil) { cs_activeToasts = [[NSMutableArray alloc] init]; objc_setAssociatedObject(self, &CSToastActiveKey, cs_activeToasts, OBJC_ASSOCIATION_RETAIN_NONATOMIC); } return cs_activeToasts; } - (NSMutableArray *)cs_toastQueue { NSMutableArray *cs_toastQueue = objc_getAssociatedObject(self, &CSToastQueueKey); if (cs_toastQueue == nil) { cs_toastQueue = [[NSMutableArray alloc] init]; objc_setAssociatedObject(self, &CSToastQueueKey, cs_toastQueue, OBJC_ASSOCIATION_RETAIN_NONATOMIC); } return cs_toastQueue; } #pragma mark - Events - (void)cs_toastTimerDidFinish:(NSTimer *)timer { [self cs_hideToast:(UIView *)timer.userInfo]; } - (void)cs_handleToastTapped:(UITapGestureRecognizer *)recognizer { UIView *toast = recognizer.view; NSTimer *timer = (NSTimer *)objc_getAssociatedObject(toast, &CSToastTimerKey); [timer invalidate]; [self cs_hideToast:toast fromTap:YES]; } #pragma mark - Activity Methods - (void)makeToastActivity:(id)position { // sanity UIView *existingActivityView = (UIView *)objc_getAssociatedObject(self, &CSToastActivityViewKey); if (existingActivityView != nil) return; CSToastStyle *style = [CSToastManager sharedStyle]; UIView *activityView = [[UIView alloc] initWithFrame:CGRectMake(0.0, 0.0, style.activitySize.width, style.activitySize.height)]; activityView.center = [self cs_centerPointForPosition:position withToast:activityView]; activityView.backgroundColor = style.backgroundColor; activityView.alpha = 0.0; activityView.autoresizingMask = (UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleRightMargin | UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleBottomMargin); activityView.layer.cornerRadius = style.cornerRadius; if (style.displayShadow) { activityView.layer.shadowColor = style.shadowColor.CGColor; activityView.layer.shadowOpacity = style.shadowOpacity; activityView.layer.shadowRadius = style.shadowRadius; activityView.layer.shadowOffset = style.shadowOffset; } UIActivityIndicatorView *activityIndicatorView = [[UIActivityIndicatorView alloc] initWithActivityIndicatorStyle:UIActivityIndicatorViewStyleWhiteLarge]; activityIndicatorView.center = CGPointMake(activityView.bounds.size.width / 2, activityView.bounds.size.height / 2); [activityView addSubview:activityIndicatorView]; [activityIndicatorView startAnimating]; // associate the activity view with self objc_setAssociatedObject (self, &CSToastActivityViewKey, activityView, OBJC_ASSOCIATION_RETAIN_NONATOMIC); [self addSubview:activityView]; [UIView animateWithDuration:style.fadeDuration delay:0.0 options:UIViewAnimationOptionCurveEaseOut animations:^{ activityView.alpha = 1.0; } completion:nil]; } - (void)hideToastActivity { UIView *existingActivityView = (UIView *)objc_getAssociatedObject(self, &CSToastActivityViewKey); if (existingActivityView != nil) { [UIView animateWithDuration:[[CSToastManager sharedStyle] fadeDuration] delay:0.0 options:(UIViewAnimationOptionCurveEaseIn | UIViewAnimationOptionBeginFromCurrentState) animations:^{ existingActivityView.alpha = 0.0; } completion:^(BOOL finished) { [existingActivityView removeFromSuperview]; objc_setAssociatedObject (self, &CSToastActivityViewKey, nil, OBJC_ASSOCIATION_RETAIN_NONATOMIC); }]; } } #pragma mark - Helpers - (CGPoint)cs_centerPointForPosition:(id)point withToast:(UIView *)toast { CSToastStyle *style = [CSToastManager sharedStyle]; UIEdgeInsets safeInsets = UIEdgeInsetsZero; if (@available(iOS 11.0, *)) { safeInsets = self.safeAreaInsets; } CGFloat topPadding = style.verticalPadding + safeInsets.top; CGFloat bottomPadding = style.verticalPadding + safeInsets.bottom; if([point isKindOfClass:[NSString class]]) { if([point caseInsensitiveCompare:CSToastPositionTop] == NSOrderedSame) { return CGPointMake(self.bounds.size.width / 2.0, (toast.frame.size.height / 2.0) + topPadding); } else if([point caseInsensitiveCompare:CSToastPositionCenter] == NSOrderedSame) { return CGPointMake(self.bounds.size.width / 2.0, self.bounds.size.height / 2.0); } } else if ([point isKindOfClass:[NSValue class]]) { return [point CGPointValue]; } // default to bottom return CGPointMake(self.bounds.size.width / 2.0, (self.bounds.size.height - (toast.frame.size.height / 2.0)) - bottomPadding); } @end @implementation CSToastStyle #pragma mark - Constructors - (instancetype)initWithDefaultStyle { self = [super init]; if (self) { self.backgroundColor = [[UIColor blackColor] colorWithAlphaComponent:0.8]; self.titleColor = [UIColor whiteColor]; self.messageColor = [UIColor whiteColor]; self.maxWidthPercentage = 0.8; self.maxHeightPercentage = 0.8; self.horizontalPadding = 10.0; self.verticalPadding = 10.0; self.cornerRadius = 10.0; self.titleFont = [UIFont boldSystemFontOfSize:16.0]; self.messageFont = [UIFont systemFontOfSize:16.0]; self.titleAlignment = NSTextAlignmentLeft; self.messageAlignment = NSTextAlignmentLeft; self.titleNumberOfLines = 0; self.messageNumberOfLines = 0; self.displayShadow = NO; self.shadowOpacity = 0.8; self.shadowRadius = 6.0; self.shadowOffset = CGSizeMake(4.0, 4.0); self.imageSize = CGSizeMake(80.0, 80.0); self.activitySize = CGSizeMake(100.0, 100.0); self.fadeDuration = 0.2; } return self; } - (void)setMaxWidthPercentage:(CGFloat)maxWidthPercentage { _maxWidthPercentage = MAX(MIN(maxWidthPercentage, 1.0), 0.0); } - (void)setMaxHeightPercentage:(CGFloat)maxHeightPercentage { _maxHeightPercentage = MAX(MIN(maxHeightPercentage, 1.0), 0.0); } - (instancetype)init NS_UNAVAILABLE { return nil; } @end @interface CSToastManager () @property (strong, nonatomic) CSToastStyle *sharedStyle; @property (assign, nonatomic, getter=isTapToDismissEnabled) BOOL tapToDismissEnabled; @property (assign, nonatomic, getter=isQueueEnabled) BOOL queueEnabled; @property (assign, nonatomic) NSTimeInterval defaultDuration; @property (strong, nonatomic) id defaultPosition; @end @implementation CSToastManager #pragma mark - Constructors + (instancetype)sharedManager { static CSToastManager *_sharedManager = nil; static dispatch_once_t oncePredicate; dispatch_once(&oncePredicate, ^{ _sharedManager = [[self alloc] init]; }); return _sharedManager; } - (instancetype)init { self = [super init]; if (self) { self.sharedStyle = [[CSToastStyle alloc] initWithDefaultStyle]; self.tapToDismissEnabled = YES; self.queueEnabled = NO; self.defaultDuration = 3.0; self.defaultPosition = CSToastPositionBottom; } return self; } #pragma mark - Singleton Methods + (void)setSharedStyle:(CSToastStyle *)sharedStyle { [[self sharedManager] setSharedStyle:sharedStyle]; } + (CSToastStyle *)sharedStyle { return [[self sharedManager] sharedStyle]; } + (void)setTapToDismissEnabled:(BOOL)tapToDismissEnabled { [[self sharedManager] setTapToDismissEnabled:tapToDismissEnabled]; } + (BOOL)isTapToDismissEnabled { return [[self sharedManager] isTapToDismissEnabled]; } + (void)setQueueEnabled:(BOOL)queueEnabled { [[self sharedManager] setQueueEnabled:queueEnabled]; } + (BOOL)isQueueEnabled { return [[self sharedManager] isQueueEnabled]; } + (void)setDefaultDuration:(NSTimeInterval)duration { [[self sharedManager] setDefaultDuration:duration]; } + (NSTimeInterval)defaultDuration { return [[self sharedManager] defaultDuration]; } + (void)setDefaultPosition:(id)position { if ([position isKindOfClass:[NSString class]] || [position isKindOfClass:[NSValue class]]) { [[self sharedManager] setDefaultPosition:position]; } } + (id)defaultPosition { return [[self sharedManager] defaultPosition]; } @end Pods/Toast/license
New file @@ -0,0 +1,20 @@ 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.
