使用开源库 TWMessageBarManager 展示系统级别的通知
TWMessageBarManager
简单翻译
https://github.com/terryworona/TWMessageBarManager
An iOS manager for presenting system-wide notifications via a dropdown message bar.
一个iOS的管理类，用来展示系统级别的通知，通过一个下拉的信息条。
Requirements
- Requires iOS 6.0 or later
- Requires Automatic Reference Counting (ARC)
- 需要iOS6.0或以上
- 需要ARC
Features
- Drop-in singleton manager supported across all devices.
- Simple to use protocols and callbacks.
- Landscape and portrait orientation support.
- Highly customizable.
- 单例模式，支持所有的种类的设备
- 可以使用协议或者block
- 支持横屏竖屏
- 高度定制
Refer to the changelog for an overview of TWMessagBarManager's feature history.
Author
Terry Worona
Tweet me @terryworona
Email me at terryworona@gmail.com
Installation
CocoaPods is the recommended method of installing the TWMessageBarManager.
推荐用CocoPods来安装吧。
The Pod Way
Simply add the following line to your Podfile:
pod 'TWMessageBarManager'
Your podfile should look something like:
platform :ios, '6.0'
pod 'TWMessageBarManager', '~> 1.4.0'The Old School Way
The simpliest way to use TWMessageBarManager with your application is to drag and drop the /Classes folder into you're Xcode 5 project. It's also recommended you rename the /Classes folder to something more descriptive (ie. "TWMessageBarManager").
最简单的方法就是，将这个 TWMessageBarManager 拖入到你的工程项目当中。当然，拖进工程之后，你也需要看看里面文件的一些描述信息。
Usage
Calling the manager
调用这个控制器
As a singleton class, the manager can be accessed from anywhere within your app via the + sharedInstancefunction:
因为他是一个单例，所以，你可以在你的应用程序的任何地方，通过方法 sharedInstance 来调用：
[TWMessageBarManager sharedInstance]
Presenting a basic message
展示一条基本的信息
All messages can be preseted via showMessageWithTitle:description:type:. Additional arguments include duration and callback blocks to be notified of a user tap.
所有的信息都可以通过showMessageWithTitle:description:type:来展示出来，额外的一些参数包括，显示时长，用户点击提示的回调。
Basic message:
基本信息：
[[TWMessageBarManager sharedInstance] showMessageWithTitle:@"Account Updated!"
description:@"Your account was successfully updated."
type:TWMessageBarMessageTypeSuccess];
The default display duration is 3 seconds. You can override this value by supplying an additional argument:
这个默认的显示时间是3s，当然啰，你也可以重写他嘛：
[[TWMessageBarManager sharedInstance] showMessageWithTitle:@"Account Updated!"
description:@"Your account was successfully updated."
type:TWMessageBarMessageTypeSuccess
forDuration:6.0];
Hiding messages
隐藏信息
It's not currently possible to hide or cancel a message on a per-instance basis. Instead, all messages must be canceled at once. This action may or may not be animated:
不大可能立刻为每一个基础信息展示隐藏或者取消掉。相对的，要取消也是所有的信息一起取消，而且是立刻，下面的方法有两种，一种是有动画的取消，一种是没有动画的取消：
[[TWMessageBarManager sharedInstance] hideAllAnimated:YES]; // animated
[[TWMessageBarManager sharedInstance] hideAll]; // non-animated
Callbacks
回调
By default, if a user taps on a message while it is presented, it will automatically dismiss. To be notified of the touch, simply supply a callback block:
默认的，当用户点击到了这条展示的信息，他将会自动消失掉，为了标记这次点击，简单的从一个回调的block中取点击事件就可以了：
[[TWMessageBarManager sharedInstance] showMessageWithTitle:@"Account Updated!"
description:@"Your account was successfully updated."
type:TWMessageBarMessageTypeSuccess callback:^{
NSLog(@"Message bar tapped!");
}];
Queue
队列
The manager is backed by a queue that can handle an infinite number of sequential requests. You can stack as many messages you want on the stack and they will be presetented one after another:
这个控制器也是可以被存储在队列中的咯，这个队列会管理一系列的请求而挨个展示。你可以将你要展示的信息挨个的添加进这个队列中吧。
[[TWMessageBarManager sharedInstance] showMessageWithTitle:@"Message 1"
description:@"Description 1"
type:TWMessageBarMessageTypeSuccess];
[[TWMessageBarManager sharedInstance] showMessageWithTitle:@"Message 2"
description:@"Description 2"
type:TWMessageBarMessageTypeError];
[[TWMessageBarManager sharedInstance] showMessageWithTitle:@"Message 3"
description:@"Description 3"
type:TWMessageBarMessageTypeInfo];
Customization
定制
An object conforming to the TWMessageBarStyleSheet protocol defines the message bar's look and feel:
一个遵守TWMessageBarStyleSheet 协议的对象定义了信息条的样式以及感觉：
+ (UIColor *)backgroundColorForMessageType:(TWMessageBarMessageType)type;
+ (UIColor *)strokeColorForMessageType:(TWMessageBarMessageType)type;
+ (UIImage *)iconImageForMessageType:(TWMessageBarMessageType)type;
If no style sheet is supplied, a default class is provided on initialization. To customize the look and feel of your message bars, simply supply an object conforming to the TWMessageBarStyleSheet protocol via:
如过你没有提供任何的设置样式，它会直接使用默认值。为了定制这个信息条的样式以及感觉，简单的提供一个与协议相关的对象进行一些配置。
@property (nonatomic, weak) id<TWMessageBarStyleSheet> styleSheet;
See TWAppDelegateDemoStyleSheet for an example on how to create a custom stylesheet.
怎么配置呢，不懂的话，请看看那个自定义的demo吧。
