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

时间:2023-12-31 17:15:38

前言:

昨天刚写了一篇IT连创业的文章:IT连创业系列:产品设计之答题模块,(欢迎大伙关注!)

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

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

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

Sagit.Framework For IOS 开发框架入门教程5:消息弹窗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];
}
}];
}

效果:

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

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

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];
}

提示效果:

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

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

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;
}

提示效果:

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

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:@"取消"]; }];
}

效果:

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

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

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]; }

效果:

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

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

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];
}

效果:

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

总结:

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

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

Sagit框架,让IOS开发更简单,你值的拥有!!!

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