当前位置: 首页 > 工具软件 > ProgressHUD > 使用案例 >

ProgressHUD源码详解

冷正信
2023-12-01

ProgressHUD源码详解

ProgressHUD是iOS开发中常用的等待控件(菊花控件),用户网络请求等

主要结构

ProgressHUD只包含两个代码文件ProgressHUD.hProgressHUD.m,以及一个资源文件ProgressHUD.bundle

ProgressHUD本质上为UIView的子类

@interface ProgressHUD : UIView
复制代码

其主要结构包含5部分:

@interface ProgressHUD()
{
	UIWindow *window;
	UIView *viewBackground;
	UIToolbar *toolbarHUD;
	UIActivityIndicatorView *spinner;
	UIImageView *imageView;
	UILabel *labelStatus;
}

复制代码

以上控件之间的结构关系如下:

初始化控件

  • show方法中调用
+ (void)show
{
	dispatch_async(dispatch_get_main_queue(), ^{
		[[self shared] hudCreate:nil image:nil spin:YES hide:NO interaction:YES];
	});
}
复制代码
  • 初始化

- (void)hudCreate:(NSString *)status image:(UIImage *)image spin:(BOOL)spin hide:(BOOL)hide interaction:(BOOL)interaction
{
    //初始化toolbarHUD
	if (toolbarHUD == nil)
	{
		toolbarHUD = [[UIToolbar alloc] initWithFrame:CGRectZero];
		toolbarHUD.translucent = YES;
		toolbarHUD.backgroundColor = self.hudColor;
		toolbarHUD.layer.cornerRadius = 10;
		toolbarHUD.layer.masksToBounds = YES;
		[self registerNotifications];
	}
	
	if (toolbarHUD.superview == nil)
	{
        //如果与背景视图不可交互,初始化背景视图,背景视图为toolbarHUD的父视图
		if (interaction == NO)
		{
			viewBackground = [[UIView alloc] initWithFrame:window.frame];
			viewBackground.backgroundColor = self.backgroundColor;
			[window addSubview:viewBackground];
			[viewBackground addSubview:toolbarHUD];
		}//如果与背景视图可交互,顶层window为toolbarHUD的父视图
		else [window addSubview:toolbarHUD];
	}
	//初始化spinner(菊花),并添加到toolbarHUD
	if (spinner == nil)
	{
		spinner = [[UIActivityIndicatorView alloc] initWithActivityIndicatorStyle:UIActivityIndicatorViewStyleWhiteLarge];
		spinner.color = self.spinnerColor;
		spinner.hidesWhenStopped = YES;
	}
	if (spinner.superview == nil) [toolbarHUD addSubview:spinner];
	//初始化imageView并添加到toolbarHUD
	if (imageView == nil)
	{
		imageView = [[UIImageView alloc] initWithFrame:CGRectMake(0, 0, 28, 28)];
	}
	if (imageView.superview == nil) [toolbarHUD addSubview:imageView];
	//初始化labelStatus,添加到toolbarHUD
	if (labelStatus == nil)
	{
		labelStatus = [[UILabel alloc] initWithFrame:CGRectZero];
		labelStatus.font = self.statusFont;
		labelStatus.textColor = self.statusColor;
		labelStatus.backgroundColor = [UIColor clearColor];
		labelStatus.textAlignment = NSTextAlignmentCenter;
		labelStatus.baselineAdjustment = UIBaselineAdjustmentAlignCenters;
		labelStatus.numberOfLines = 0;
	}
	if (labelStatus.superview == nil) [toolbarHUD addSubview:labelStatus];

    //文本信息添加
	labelStatus.text = status;
	labelStatus.hidden = (status == nil) ? YES : NO;
	//图片信息添加
	imageView.image = image;
	imageView.hidden = (image == nil) ? YES : NO;
	//spinner(菊花)旋转(或停止)
	if (spin) [spinner startAnimating]; else [spinner stopAnimating];
	
	[self hudSize];//尺寸设置
	[self hudPosition:nil];//位置设置
	[self hudShow];//动画显示
	//定时关闭
	if (hide) [self timedHide];
}

复制代码

设置Size


- (void)hudSize
{
	CGRect rectLabel = CGRectZero;
	CGFloat widthHUD = 100, heightHUD = 100;//toolbarHUD默认的尺寸
	if (labelStatus.text != nil)
	{
		NSDictionary *attributes = @{NSFontAttributeName:labelStatus.font};
		NSInteger options = NSStringDrawingUsesFontLeading | NSStringDrawingTruncatesLastVisibleLine | NSStringDrawingUsesLineFragmentOrigin;
		rectLabel = [labelStatus.text boundingRectWithSize:CGSizeMake(200, 300) options:options attributes:attributes context:NULL];//计算文字所需的Rect

        //toolbarHUD对应的Rect
		widthHUD = rectLabel.size.width + 50;
		heightHUD = rectLabel.size.height + 75;

		if (widthHUD < 100) widthHUD = 100;
		if (heightHUD < 100) heightHUD = 100;

		rectLabel.origin.x = (widthHUD - rectLabel.size.width) / 2;
		rectLabel.origin.y = (heightHUD - rectLabel.size.height) / 2 + 25;
	}
	
	toolbarHUD.bounds = CGRectMake(0, 0, widthHUD, heightHUD);
	//imageView对应的位置
	CGFloat imageX = widthHUD/2;
	CGFloat imageY = (labelStatus.text == nil) ? heightHUD/2 : 36;
	imageView.center = spinner.center = CGPointMake(imageX, imageY);
	
	labelStatus.frame = rectLabel;
}

复制代码

设置postion

- (void)hudPosition:(NSNotification *)notification
{
	CGFloat heightKeyboard = 0;
	NSTimeInterval duration = 0;
	//计算键盘高度
	if (notification != nil)
	{
		NSDictionary *info = [notification userInfo];
		CGRect keyboard = [[info valueForKey:UIKeyboardFrameEndUserInfoKey] CGRectValue];
		duration = [[info valueForKey:UIKeyboardAnimationDurationUserInfoKey] doubleValue];
		if ((notification.name == UIKeyboardWillShowNotification) || (notification.name == UIKeyboardDidShowNotification))
		{
			heightKeyboard = keyboard.size.height;
		}
	}
	else heightKeyboard = [self keyboardHeight];
	//toolbarHUD的水平中心在屏幕中间,垂直中心在除去键盘高度的中心。
	CGRect screen = [UIScreen mainScreen].bounds;
	CGPoint center = CGPointMake(screen.size.width/2, (screen.size.height-heightKeyboard)/2);
	//动态设置toolbarHUD的中心
	[UIView animateWithDuration:duration delay:0 options:UIViewAnimationOptionAllowUserInteraction animations:^{
		self->toolbarHUD.center = CGPointMake(center.x, center.y);
	} completion:nil];
	if (viewBackground != nil) viewBackground.frame = window.frame;
}

复制代码
  • 注意:
  1. toolbarHUD的水平中心在屏幕中间,垂直中心在除去键盘高度的中心。
CGPoint center = CGPointMake(screen.size.width/2, (screen.size.height-heightKeyboard)/2);
复制代码
  1. toolbarHUD的垂直中心会根据键盘消息进行调整。

显示

- (void)hudShow
{
	if (self.alpha == 0)
	{
		self.alpha = 1;
		toolbarHUD.alpha = 0; //初始设置为完全透明,实现隐藏功能
		toolbarHUD.transform = CGAffineTransformScale(toolbarHUD.transform, 1.4, 1.4); //放大

		UIViewAnimationOptions options = UIViewAnimationOptionAllowUserInteraction | UIViewAnimationCurveEaseOut; //动画模式设置
        //动画显示
		[UIView animateWithDuration:0.15 delay:0 options:options animations:^{
			self->toolbarHUD.transform = CGAffineTransformScale(self->toolbarHUD.transform, 1/1.4, 1/1.4); //恢复正常
			self->toolbarHUD.alpha = 1; //设为不透明,显示出来
		} completion:nil];
	}
}
复制代码

隐藏

- (void)hudHide
{
	if (self.alpha == 1)
	{
		UIViewAnimationOptions options = UIViewAnimationOptionAllowUserInteraction | UIViewAnimationCurveEaseIn; //动画模式设置
		[UIView animateWithDuration:0.15 delay:0 options:options animations:^{
			self->toolbarHUD.transform = CGAffineTransformScale(self->toolbarHUD.transform, 0.7, 0.7); //缩小为原来的0.7倍
			self->toolbarHUD.alpha = 0; //设置为透明,实现隐藏
		}
		completion:^(BOOL finished) {
			[self hudDestroy]; //删除各控件的依赖关系,再删除控件
			self.alpha = 0;
		}];
	}
}

复制代码

转载于:https://juejin.im/post/5afaa786f265da0b71566cdd

 类似资料: