Sagit.Framework For IOS 开发框架入门教程5：消息弹窗STMsgBox

前言：

昨天刚写了一篇IT连创业的文章：IT连创业系列：产品设计之答题模块，（欢迎大伙关注！）

感觉好久没写IOS的文章了，今天趁机，来补一篇，Sagit的教程。

Sagit 开源地址：https://github.com/cyq1162/Sagit

今天主要是分享消息弹窗功能，即STMsgBox的用法：

STMsgBox为弹窗相关的功能的源码。

1､对外API功能调用说明：

早期的弹窗，曾经引用了MBProgressHUD；

后来，去掉了，并重写了里面所有的代码。

目前对外调用的API：

typedef BOOL (^OnConfirmClick)(NSInteger btnIndex,UIAlertView* view);
typedef BOOL (^OnBeforeDialogHide)(UIView* winView,UIView* clickView);
typedef void (^OnBeforeShow)(UIAlertView* view);
typedef void (^OnDialogShow)(UIView* winView);
//!提供基础的消息弹窗
@interface STMsgBox : NSObject
+ (STMsgBox*)share;

#pragma AlertView
//!提示消息
-(void)prompt:(id)msg;
-(void)prompt:(id)msg second:(NSInteger)second;
//!弹出需要点击确定的消息框
-(void)alert:(id)msg;
-(void)alert:(id)msg title:(NSString*)title;
-(void)alert:(id)msg title:(NSString *)title okText:(NSString*)okText;
-(void)loading;
-(void)loading:(id)text;
-(void)hideLoading;
//!弹出需要确认，并可执行事件的消息框。
-(void)confirm:(id)msg title:(NSString*)title click:(OnConfirmClick)click;
-(void)confirm:(id)msg title:(NSString *)title click:(OnConfirmClick)click okText:(NSString*)okText;
-(void)confirm:(id)msg title:(NSString *)title click:(OnConfirmClick)click okText:(NSString*)okText  cancelText:(NSString*)cancelText;
//!弹出一个可以(自定义)输入内容的对话框
-(void)input:(id)title before:(OnBeforeShow)beforeShow click:(OnConfirmClick)click okText:(NSString*)okText  cancelText:(NSString*)cancelText;
//!弹出自定义界面的对话框
- (void)dialog:(OnDialogShow)dialog;
- (void)dialog:(OnDialogShow)dialog beforeHide:(OnBeforeDialogHide) beforeHide;
@end

2、调用方式

对于该类的调用方式，有两种

1､在继承自STController的控制器下，直接用[self.msgBox ...]

STController这个基类，默认实现的有两个子类接口（msgBox：消息弹窗、http：网络请求）

例如：

[self.msgBox prompt:@"不能为空!"];

2､在任意地方，都可以全局的调用：用[Sagit.MsgBox ...]

Sagit，是一个总类库的起始名称空间，很多常用功能，都是由Sagit打开头开始，后续会单独介绍。

例如：

[Sagit.MsgBox prompt:@"加入黑名单成功!"];

3、项目代码实例

下面，会和大伙分享 IT连App 中，应用到该相关的代码：

A、prompt用法：发布圈子的时候，弹出提示

-(void)onRightNavBarClick:(UIBarButtonItem *)view
{
    if(![self isMatch:@"发布内容" name:@"topic"])
    {
        return;
    }

    NSString *jsonStr = [@{@"TopicContent":STValue(@"topic"),@"photos":self.photos} toJson];
    [self.http post:UrlTopicSet paras:@{@"topic":jsonStr} success:^(STModel *result) {
        if (result.success == YES)
        {
            [self.msgBox prompt:@"发布成功!"];
            [self.preController reloadData];
            [self stPop];
        }
        else
        {
            [self.msgBox prompt:result.msg];
        }
    }];
}

效果：

B、alert用法：小魔术（露一手）中的穿透术，未设置参数时的提示

-(void)initUI
{
    [super initUI];
    [self loadScreenUI];
    //禁止用户自定义图片，显示为用户设置的穿透图片
    self.userPhotos=nil;
    self.showSecond=;
    //读取设置的图片
    self.penPhotos=Sagit.Magic.Setting.penPhotos;
    if(!self.penPhotos || self.penPhotos.count==)
    {
        [self.msgBox alert:@"请先在参数设置里设置穿透照片!" title:@"消息提示" okText:@"我知道了"];
        [self stPop];
        return;
    }
    [self ready];
}

提示效果：

C、confirm 的用法：图片长按的提示保存

-(UIImageView*)save
{
    [Sagit.MsgBox confirm:@"是否保存图片？" title:@"消息提示" click:^BOOL(NSInteger isOK,UIAlertView* view) {
        if(isOK>)
        {
            [self.image save:^(NSError *err) {
                [Sagit.MsgBox prompt:!err?@"保存成功":@"保存失败:保存照片权限被拒绝，您需要重新设置才能保存！"];
            }];
        }
        return YES;
    }];
    return self;
}

提示效果：

 

D、input用法：修改密码时的用法

-(void)updatePassword:(UITableViewCell*)cell
{
    [[cell.textLabel text:@"修改密码"] onClick:^(id view) {
        [self.msgBox input:@"修改密码" before:^(UIAlertView *view) {
            view.alertViewStyle=UIAlertViewStyleSecureTextInput;
            [[view textFieldAtIndex:] keyboardType:UIKeyboardTypeNumbersAndPunctuation];
        }  click:^BOOL(NSInteger isOK, UIAlertView *view) {
            if(isOK>)
            {
                UITextField *text=[view textFieldAtIndex:];
                if (![self isMatch:@"密码,格式为6-16位数字或字母" value:text.text regex:RexPassword])
                {
                    return NO;
                }
                [self.http post:UrlChangePwd paras:@{@"Password":text.text} success:^(STModel *result) {
                    if (result.success) {
                        [self.msgBox prompt:@"密码修改成功"];
                        Sagit.Global.Token=(NSString *)result.msg;
                    }else {
                        [self.msgBox prompt:@"密码修改失败"];
                    }
                }];
            }
            return YES;
        } okText:@"确认密码" cancelText:@"取消"];

    }];
}

效果：

E、dialog用法，自定义窗体：弹出分享模块的用法

- (void)show:(ShareModel*)model after:(OnAfterShare)after beforeViewHide:(OnBeforeDialogHide)onBeforeViewHide
{
    [Sagit.MsgBox dialog:^(UIView *winView) {
        [[[[[winView addUIView:nil] width: height:] backgroundColor:DeviceColor] relate:Bottom v:] block:nil on:^(UIView* sView)
         {
             NSArray *shareImageArray = @[@"wechat2", @"wechat", @"qq", @"qq2"];
             NSArray *shareTitleArray = @[@"微信好友", @"微信朋友圈", @"QQ好友", @"QQ空间"];
             for (int i = ; i < shareImageArray.count; i ++)
             {
                 UIImageView *imgView= [[[[sView addImageView:nil img:shareImageArray[i]] width: height:] relate:LeftTop v:(+)*i+ v2:] onClick:^(id view) {
                     model.To=(ShareTo)i;
                     [self send:model after:after];
                     [winView click];//隐藏界面
                 }];
                 [[[[[sView addLabel:nil text:shareTitleArray[i] font: color:@"#555555"] textAlignment:NSTextAlignmentCenter] width:] onBottom:imgView y:] onClick:^(id view) {
                     [imgView click];
                 }];
             }
             [[[[[sView addUIView:nil] backgroundColor:ColorWhite] width: height:]relate:Bottom v:] block:nil on:^(UIView* cancelView) {
                 [[cancelView addLabel:nil text:@"取消" font: color:ColorBlack] toCenter];
             }];
         }];

    } beforeHide:onBeforeViewHide];

}

效果：

F、dialog用法2：弹出答题中的难度

- (void)show:(NSString*)type
{
    [Sagit.MsgBox dialog:^(UIView *winView) {
        [[[[winView addImageView:nil img:@"answer_pop"] width: height:] toCenter] block:nil on:^(UIImageView *cView) {
            //初级
            [[[[cView addUIView:@"level1"] width: height:] relate:LeftTop v: v2:] onClick:^(UIView* view) {
                [self showAnswerStart:winView questionType:type dificulty:@""];
            }];
            //中级
            [[[[cView addUIView:@"level2"] width: height:] onRight:@"level1" x: ]onClick:^(UIView* view) {
                 [self showAnswerStart:winView questionType:type dificulty:@""];
            }];
            //高级
            [[[[[cView addUIView:@"level3"] width: height:] onBottom:@"level2" y:] toCenter:X] onClick:^(UIView* view) {
                [self showAnswerStart:winView questionType:type dificulty:@""];
            }];
            //我要出题
            [[[[cView addUIView:@"level4"] width: height:] relate:LeftTop v: v2:] onClick:^(UIView* view) {
                [winView click];
                ITWebViewController *wv=[ITWebViewController new];
                NSString *url=[[UrlQuestionPost replace:@"{uid}" with:Sagit.Global.UserID] replace:@"{qt}" with:type];
                [wv loadUrl:url];
                NSString *qtName=[Sagit.Global getConfigKey:@"答题类型" value:type];
                wv.defaultTitle=STString(@"我要出题: %@",qtName);
                wv.denyChangeTitle=YES;
                [self stPush:wv];
            }];
        }];
    }];
}
-(void)showAnswerStart:(UIView*)view questionType:(NSString*)type dificulty:(NSString*)dificulty
{
    AnswerModel *model=[AnswerModel new];
    model.Score=;
    model.StartTime=[NSDate.beiJinDate toString];
    model.AnswerCount=;
    model.QuestionType=type.integerValue;
    model.QuestionDifficulty=dificulty.integerValue;

    UIViewController *con=[STNew(@"AnswerStart") key:@"answerModel" value:model] ;
    [self stPush:con title:nil img:nil];
    [view click];
}

效果：

总结：

本篇虽然介绍的是消息弹窗，但分享的代码，都是IT连里完整的功能模块了。

认真扫代码，就能发现用Sagit框架写代码是简洁的不要不要的了。

Sagit框架，让IOS开发更简单，你值的拥有！！！