前言：
昨天刚写了一篇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开发更简单，你值的拥有！！！