说明：
2021-10-26 版本更新：UIAlertView（已过时） 调整为：UIAlertController 实现。
文章内容中：UIAlertView* view 参数统一变更为：UIAlertController* alertController
前言：
Sagit 开源地址：https://github.com/cyq1162/Sagit
今天主要是分享消息弹窗功能，即STMsgBox的用法：
STMsgBox为弹窗相关的功能的源码。
1､对外API功能调用说明：
对外调用的API：
typedef void (^OnConfirmClick)(NSInteger btnIndex,UIAlertView* view); typedef BOOL (^OnInputClick)(NSInteger btnIndex,UIAlertView* view); typedef void (^OnMenuClick)(NSInteger btnIndex,UIActionSheet* view); typedef BOOL (^OnBeforeDialogHide)(UIView* winView,UIView* clickView); typedef void (^OnBeforeShow)(UIAlertView* view); typedef void (^OnDialogShow)(UIView* winView); //!提供基础的消息弹窗 @interface STMsgBox : NSObject + (STMsgBox*)share; //!dialog 状态。 @property (nonatomic,assign) BOOL isDialoging; #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:(OnInputClick)click okText:(NSString*)okText cancelText:(NSString*)cancelText; //!弹出底部菜单 -(void)menu:(OnMenuClick)click names:(id)names,...NS_REQUIRES_NIL_TERMINATION; //!弹出自定义界面的对话框 - (void)dialog:(OnDialogShow)dialog; - (void)dialog:(OnDialogShow)dialog beforeHide:(OnBeforeDialogHide) beforeHide;
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=2; //读取设置的图片 self.penPhotos=Sagit.Magic.Setting.penPhotos; if(!self.penPhotos || self.penPhotos.count==0) { [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>0) { [self.image save:^(NSError *err) { [Sagit.MsgBox prompt:!err?@"保存成功":@"保存失败:保存照片权限被拒绝，您需要重新设置才能保存！"]; }]; } return YES; }]; return self; }
提示效果：
confirm的用法2：【当okText 为多个项时（字符串用逗号分隔）】
[self.msgBox confirm:nil title:@"模式切换" click:^void(NSInteger btnIndex, UIAlertView *view) { if(btnIndex>0) { if(Sagit.Event.onChangeMenu) { Sagit.Event.onChangeMenu(btnIndex,YES); } } } okText:@"爱情,学习"];//,工作
效果：
D、input用法：修改密码时的用法
-(void)updatePassword:(UITableViewCell*)cell { [[cell.textLabel text:@"修改密码"] onClick:^(id view) { [self.msgBox input:@"修改密码" before:^(UIAlertView *view) { view.alertViewStyle=UIAlertViewStyleSecureTextInput; [[view textFieldAtIndex:0] keyboardType:UIKeyboardTypeNumbersAndPunctuation]; } click:^BOOL(NSInteger isOK, UIAlertView *view) { if(isOK>0) { UITextField *text=[view textFieldAtIndex:0]; 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:1 height:362] backgroundColor:DeviceColor] relate:Bottom v:0] block:nil on:^(UIView* sView) { NSArray *shareImageArray = @[@"wechat2", @"wechat", @"qq", @"qq2"]; NSArray *shareTitleArray = @[@"微信好友", @"微信朋友圈", @"QQ好友", @"QQ空间"]; for (int i = 0; i < shareImageArray.count; i ++) { UIImageView *imgView= [[[[sView addImageView:nil img:shareImageArray[i]] width:126 height:126] relate:LeftTop v:(126+36)*i+72 v2:50] onClick:^(id view) { model.To=(ShareTo)i; [self send:model after:after]; [winView click];//隐藏界面 }]; [[[[[sView addLabel:nil text:shareTitleArray[i] font:24 color:@"#555555"] textAlignment:NSTextAlignmentCenter] width:126] onBottom:imgView y:22] onClick:^(id view) { [imgView click]; }]; } [[[[[sView addUIView:nil] backgroundColor:ColorWhite] width:1 height:98]relate:Bottom v:0] block:nil on:^(UIView* cancelView) { [[cancelView addLabel:nil text:@"取消" font:32 color:ColorBlack] toCenter]; }]; }]; } beforeHide:onBeforeViewHide]; }
效果：
F、dialog用法2：弹出答题中的难度
- (void)show:(NSString*)type { [Sagit.MsgBox dialog:^(UIView *winView) { [[[[winView addImageView:nil img:@"answer_pop"] width:1 height:814] toCenter] block:nil on:^(UIImageView *cView) { //初级 [[[[cView addUIView:@"level1"] width:140 height:62] relate:LeftTop v:216 v2:344] onClick:^(UIView* view) { [self showAnswerStart:winView questionType:type dificulty:@"1"]; }]; //中级 [[[[cView addUIView:@"level2"] width:140 height:62] onRight:@"level1" x:42 ]onClick:^(UIView* view) { [self showAnswerStart:winView questionType:type dificulty:@"2"]; }]; //高级 [[[[[cView addUIView:@"level3"] width:140 height:62] onBottom:@"level2" y:60] toCenter:X] onClick:^(UIView* view) { [self showAnswerStart:winView questionType:type dificulty:@"3"]; }]; //我要出题 [[[[cView addUIView:@"level4"] width:154 height:154] relate:LeftTop v:435 v2:538] 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=0; model.StartTime=[NSDate.beiJinDate toString]; model.AnswerCount=1; 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]; }
效果：
E、底部菜单
示例代码：
[Sagit.MsgBox menu:^void(NSInteger btnIndex, UIActionSheet *view) { [Sagit.MsgBox prompt:STString(@"%@,%@",@(btnIndex),view.name) ]; } names:@"a",@"b", nil];
效果：
总结：
本篇虽然介绍的是消息弹窗，但分享的代码，都是IT连里完整的功能模块了。
认真扫代码，就能发现用Sagit框架写代码是简洁的不要不要的了。
Sagit框架，让IOS开发更简单，你值的拥有！！！
版权声明：程序员胖胖胖虎阿 发表于 2022年9月26日 上午12:56。
转载请注明：Sagit.Framework For IOS 开发框架入门教程5：消息弹窗STMsgBox | 胖虎的工具箱-编程导航
转载请注明：Sagit.Framework For IOS 开发框架入门教程5：消息弹窗STMsgBox | 胖虎的工具箱-编程导航
相关文章
暂无评论...
致力于称为最好的程序员导航网站