iToast 0.0.1

iToast 0.0.1

测试测试
语言语言 Obj-CObjective C
许可证 自定义
发布最新发布2014年12月

未声明的维护。



iToast 0.0.1

  • 作者
  • ecstasy2

什么是iToast

本页告诉您托盘通知是什么以及为什么您可能在您的iPhone/iPad应用程序中需要它们。


如果您已经为Android开发,那么您知道它是这样的,您可以直接跳到下一节。

对于我们其他人:托盘是一种特殊的向用户显示'非侵入性'消息的方式。这些消息会在屏幕上的可配置位置显示,并在可配置的时间间隔后消失。它们出现的方式类似于Mac上的Growl应用(on mac do)。

iToast与Android上的Toast之间的区别

  • 即使已配置的时间未到,iToast在被用户触摸时也会消失。
  • iToast可以附加一个图像图标(信息、警告、错误)。
  • 有一个应用范围内的配置对象,您可以使用它让所有的iToast看起来都一样。
  • 我们计划添加一个基于插件的系统,这样我们就可以提供许多外观来替代默认值。
  • iToast宣传调用链以提高效率,这样您只需一条指令就可以创建具有任意配置的任何iToast。

使用托盘的好处

一些好处如下

  • 用户不会被此类警报分散注意力,只是注意到它们:他不需要点击"确定"。以惯例,我们现在在所有我们原本要放置单个按钮的UIAlertView中使用iToast。
  • 您可以在屏幕上的任何位置添加它,具体取决于iToast的重要性。我们使用Top的重力显示中等重要性的消息,当它是非常重要时显示在中心,当它不重要时显示在底部。# 如何使用iToast。

简单用法

创建iToast只有一种方法:所以您不需要保留太多。在其基本形式下,您按照如下方式创建iToast

[[iToast makeText:NSLocalizedString(@"The activity has been successfully saved.", @"")] show];

链式调用

类似于jQuery,您可以使用show方法来链接调用,并进行很多配置。请参见以下内容。

[[[iToast makeText:NSLocalizedString(@"The activity has been successfully saved.", @"")] 
            setGravity:iToastGravityBottom] show];

注意:重力可以是iToastGravityBottomiToastGravityTopiToastGravityCenter之一。

  • 您还可以提供屏幕上的一个物理位置:请参阅类接口。
  • 您还可以提供两个偏移值,它们将被添加到iToast的实际位置:您可以使用此功能将其移动几个像素到左侧(负offsetLeft)、右侧(正offsetLeft)、顶部或底部。

或者

[[[[iToast makeText:NSLocalizedString(@"Something to display a very long time", @"")] 
                    setGravity:iToastGravityBottom] setDuration:iToastDurationLong] show];

注意: 上面的持续时间可以是任何整数(显示时的毫秒数)。有三种预设的持续时间可供使用

  • iToastDurationLong
  • iToastDurationShort
  • iToastDurationNormal

界面

@interface iToast : NSObject {
    iToastSettings *_settings;
    NSInteger offsetLeft;
    NSInteger offsetTop;

    NSTimer *timer;

    UIView *view;
    NSString *text;
}

- (void) show;

- (iToast *) setDuration:(NSInteger ) duration;
- (iToast *) setGravity:(iToastGravity) gravity 
             offsetLeft:(NSInteger) left
             offsetTop:(NSInteger) top;
- (iToast *) setGravity:(iToastGravity) gravity;
- (iToast *) setPostion:(CGPoint) position;

+ (iToast *) makeText:(NSString *) text;

-(iToastSettings *) theSettings;

@end

共享设置

每次想显示 iToast 时,您不需要设置所有设置。有一个共享设置仓库,每个 iToast 在第一次创建时都会复制其设置。

要修改共享设置,您首先获取共享设置,如下所示

iToastSettings *theSettings = [iToastSettings getSharedSettings];

然后更改设置

theSettings.duration = 4000;

SharedSettings 接口

 @interface iToastSettings : NSObject<NSCopying>{
NSInteger duration;
iToastGravity gravity;
CGPoint postition;
iToastType toastType;

NSDictionary *images;

BOOL positionIsSet;
}


@property(assign) NSInteger duration;
@property(assign) iToastGravity gravity;
@property(assign) CGPoint postition;
@property(readonly) NSDictionary *images;


- (void) setImage:(UIImage *)img forType:(iToastType) type;
+ (iToastSettings *) getSharedSettings;

@end

尚未实现

您对那些功能感兴趣吗?编写代码并与社区分享。

  • 根据 iToast 的类型显示图标。
  • 插件式界面可自定义 toast。