SGNavigationProgress源码解读从SGProgressView到分类实现的完整架构【免费下载链接】SGNavigationProgressA category for showing a Messages like progress view on a UINavigationBar项目地址: https://gitcode.com/gh_mirrors/sg/SGNavigationProgress想要为你的iOS应用添加类似Safari浏览器的导航栏进度条效果吗SGNavigationProgress是一个轻量级、易用的Objective-C库专门为UINavigationController设计的进度指示器组件。这个开源项目通过分类Category的方式为iOS开发者提供了一种优雅的方式在导航栏上显示进度条无论是文件上传、下载还是其他耗时操作的进度展示都能让你的应用体验更加专业。 项目核心功能与架构设计SGNavigationProgress的核心设计理念是简单易用、高度可定制。项目采用分类Category设计模式在不修改UINavigationController原有代码的基础上为其添加了进度条功能。这种设计模式的优势在于零侵入性不需要继承或修改系统类即插即用导入即可使用无需复杂配置内存安全自动管理进度条的生命周期整个项目的架构非常清晰主要包含两个核心文件SGProgressView自定义的进度条视图组件UINavigationControllerSGProgress为导航控制器添加进度条功能的分类 SGProgressView轻量级进度条组件解析SGProgressView是整个项目的视觉核心它是一个高度仅为2.5pt的轻量级视图组件。在SGProgressView.m文件中我们可以看到其简洁而高效的设计// 关键属性设置 property (nonatomic, assign) float progress; property (nonatomic, strong) UIView *progressBar;SGProgressView的进度更新机制非常巧妙通过重写setProgress:方法根据进度值动态计算进度条的宽度并平滑地更新UI。这种设计确保了进度更新的流畅性和性能效率。核心特点自动裁剪超出边界的部分clipsToBounds YES支持自定义颜色通过tintColor属性进度值自动限制在0-1范围内帧更新时的自动重绘机制️ UINavigationControllerSGProgress分类实现的艺术这是项目的核心创新点通过分类为系统类添加新功能。在UINavigationControllerSGProgress.m中我们可以看到完整的实现逻辑1. 进度条管理机制- (SGProgressView *)progressView { // 智能查找或创建进度条视图 for (UIView *subview in [self.navigationBar subviews]) { if ([subview isKindOfClass:[SGProgressView class]]) { return (SGProgressView *)subview; } } // 如果不存在则创建新的进度条 // ... }这种方法确保了单例模式的效果每个导航栏最多只有一个进度条实例避免了重复创建和内存泄漏问题。2. 遮罩层设计SGNavigationProgress提供了遮罩模式可以在显示进度条的同时为屏幕其他部分添加半透明遮罩增强用户的注意力集中效果。遮罩层的实现同样采用智能查找机制- (BOOL)hasSGProgressMask { for (UIView *subview in [self.view subviews]) { if (subview.tag SGProgressMiniMasktagId || subview.tag SGProgressMasktagId) { return YES; } } return NO; }3. 丰富的API设计项目提供了多种使用方式满足不同场景需求定时进度模式// 3秒自动完成的进度条 [self.navigationController showSGProgress]; // 自定义时长和颜色 [self.navigationController showSGProgressWithDuration:5 andTintColor:[UIColor blueColor]];百分比控制模式// 手动控制进度百分比 [self.navigationController setSGProgressPercentage:75]; // 带标题和遮罩的百分比控制 [self.navigationController setSGProgressMaskWithPercentage:50 andTitle:正在上传...]; 快速集成指南安装方式CocoaPods安装推荐pod SGNavigationProgress手动集成将UINavigationControllerSGProgress.h和UINavigationControllerSGProgress.m添加到项目导入头文件#import UINavigationControllerSGProgress.h基础使用示例// 显示3秒自动完成的进度条 [self.navigationController showSGProgress]; // 显示带遮罩和自定义标题的进度条 [self.navigationController showSGProgressWithMaskAndDuration:3 andTitle:加载中...]; // 手动控制进度适合文件上传/下载 [self.navigationController setSGProgressPercentage:currentProgress]; 最佳实践与使用技巧1. 选择合适的进度模式定时模式适合已知时长的操作如页面加载百分比模式适合文件上传、下载等可变时长的操作2. 标题动态更新SGNavigationProgress支持在显示进度条时动态更新导航栏标题这在需要显示状态信息的场景中非常有用// 显示进度条并更新标题 [self.navigationController showSGProgressWithDuration:3 andTintColor:[UIColor blueColor] andTitle:正在发送...];3. 旋转适配项目已经考虑了设备旋转的情况在willRotateToInterfaceOrientation:方法中自动更新遮罩层的位置确保在不同方向下都能正确显示。4. 内存管理进度条和遮罩层都有完善的自动清理机制在进度完成后会自动从视图层级中移除避免内存泄漏。 高级定制与扩展自定义颜色方案// 使用自定义颜色 [self.navigationController showSGProgressWithDuration:3 andTintColor:[UIColor colorWithRed:0.2 green:0.6 blue:0.8 alpha:1.0]];进度完成回调虽然项目本身没有直接提供完成回调但你可以结合动画完成块来实现[self.navigationController showSGProgressWithDuration:3]; // 3秒后执行完成操作 dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{ // 进度完成后的操作 NSLog(进度完成); }); 性能优化建议避免频繁更新对于百分比模式建议不要过于频繁地调用setSGProgressPercentage:可以适当降低更新频率合理使用遮罩遮罩层会增加视图层级在不需要时尽量避免使用及时清理使用finishSGProgress或cancelSGProgress及时结束进度显示 设计理念总结SGNavigationProgress的成功之处在于其简洁而强大的设计分类设计模式不修改系统类保持代码的纯净性智能视图管理自动查找和重用现有视图提高性能灵活的API提供多种使用方式满足不同场景需求完善的动画流畅的进度动画和渐入渐出效果良好的兼容性支持iOS各种版本和设备旋转 实际应用场景这个库特别适合以下应用场景网络请求进度文件上传/下载的进度展示页面加载指示网页或内容加载时的进度提示表单提交表单数据提交时的进度反馈多步骤操作多步骤流程的进度指示后台任务后台处理任务的进度可视化结语SGNavigationProgress是一个设计精良、使用简单的iOS进度条组件通过深入分析其源码我们不仅学到了如何实现一个优雅的进度指示器更重要的是理解了分类设计模式在实际项目中的应用价值。无论是新手开发者还是有经验的iOS工程师都能从这个项目中获得启发和实用的代码实现思路。通过合理的架构设计和简洁的APISGNavigationProgress为iOS应用提供了专业级的进度指示解决方案值得在需要进度展示功能的应用中采用和借鉴。【免费下载链接】SGNavigationProgressA category for showing a Messages like progress view on a UINavigationBar项目地址: https://gitcode.com/gh_mirrors/sg/SGNavigationProgress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
SGNavigationProgress源码解读：从SGProgressView到分类实现的完整架构
发布时间：2026/6/20 16:23:10
SGNavigationProgress源码解读从SGProgressView到分类实现的完整架构【免费下载链接】SGNavigationProgressA category for showing a Messages like progress view on a UINavigationBar项目地址: https://gitcode.com/gh_mirrors/sg/SGNavigationProgress想要为你的iOS应用添加类似Safari浏览器的导航栏进度条效果吗SGNavigationProgress是一个轻量级、易用的Objective-C库专门为UINavigationController设计的进度指示器组件。这个开源项目通过分类Category的方式为iOS开发者提供了一种优雅的方式在导航栏上显示进度条无论是文件上传、下载还是其他耗时操作的进度展示都能让你的应用体验更加专业。 项目核心功能与架构设计SGNavigationProgress的核心设计理念是简单易用、高度可定制。项目采用分类Category设计模式在不修改UINavigationController原有代码的基础上为其添加了进度条功能。这种设计模式的优势在于零侵入性不需要继承或修改系统类即插即用导入即可使用无需复杂配置内存安全自动管理进度条的生命周期整个项目的架构非常清晰主要包含两个核心文件SGProgressView自定义的进度条视图组件UINavigationControllerSGProgress为导航控制器添加进度条功能的分类 SGProgressView轻量级进度条组件解析SGProgressView是整个项目的视觉核心它是一个高度仅为2.5pt的轻量级视图组件。在SGProgressView.m文件中我们可以看到其简洁而高效的设计// 关键属性设置 property (nonatomic, assign) float progress; property (nonatomic, strong) UIView *progressBar;SGProgressView的进度更新机制非常巧妙通过重写setProgress:方法根据进度值动态计算进度条的宽度并平滑地更新UI。这种设计确保了进度更新的流畅性和性能效率。核心特点自动裁剪超出边界的部分clipsToBounds YES支持自定义颜色通过tintColor属性进度值自动限制在0-1范围内帧更新时的自动重绘机制️ UINavigationControllerSGProgress分类实现的艺术这是项目的核心创新点通过分类为系统类添加新功能。在UINavigationControllerSGProgress.m中我们可以看到完整的实现逻辑1. 进度条管理机制- (SGProgressView *)progressView { // 智能查找或创建进度条视图 for (UIView *subview in [self.navigationBar subviews]) { if ([subview isKindOfClass:[SGProgressView class]]) { return (SGProgressView *)subview; } } // 如果不存在则创建新的进度条 // ... }这种方法确保了单例模式的效果每个导航栏最多只有一个进度条实例避免了重复创建和内存泄漏问题。2. 遮罩层设计SGNavigationProgress提供了遮罩模式可以在显示进度条的同时为屏幕其他部分添加半透明遮罩增强用户的注意力集中效果。遮罩层的实现同样采用智能查找机制- (BOOL)hasSGProgressMask { for (UIView *subview in [self.view subviews]) { if (subview.tag SGProgressMiniMasktagId || subview.tag SGProgressMasktagId) { return YES; } } return NO; }3. 丰富的API设计项目提供了多种使用方式满足不同场景需求定时进度模式// 3秒自动完成的进度条 [self.navigationController showSGProgress]; // 自定义时长和颜色 [self.navigationController showSGProgressWithDuration:5 andTintColor:[UIColor blueColor]];百分比控制模式// 手动控制进度百分比 [self.navigationController setSGProgressPercentage:75]; // 带标题和遮罩的百分比控制 [self.navigationController setSGProgressMaskWithPercentage:50 andTitle:正在上传...]; 快速集成指南安装方式CocoaPods安装推荐pod SGNavigationProgress手动集成将UINavigationControllerSGProgress.h和UINavigationControllerSGProgress.m添加到项目导入头文件#import UINavigationControllerSGProgress.h基础使用示例// 显示3秒自动完成的进度条 [self.navigationController showSGProgress]; // 显示带遮罩和自定义标题的进度条 [self.navigationController showSGProgressWithMaskAndDuration:3 andTitle:加载中...]; // 手动控制进度适合文件上传/下载 [self.navigationController setSGProgressPercentage:currentProgress]; 最佳实践与使用技巧1. 选择合适的进度模式定时模式适合已知时长的操作如页面加载百分比模式适合文件上传、下载等可变时长的操作2. 标题动态更新SGNavigationProgress支持在显示进度条时动态更新导航栏标题这在需要显示状态信息的场景中非常有用// 显示进度条并更新标题 [self.navigationController showSGProgressWithDuration:3 andTintColor:[UIColor blueColor] andTitle:正在发送...];3. 旋转适配项目已经考虑了设备旋转的情况在willRotateToInterfaceOrientation:方法中自动更新遮罩层的位置确保在不同方向下都能正确显示。4. 内存管理进度条和遮罩层都有完善的自动清理机制在进度完成后会自动从视图层级中移除避免内存泄漏。 高级定制与扩展自定义颜色方案// 使用自定义颜色 [self.navigationController showSGProgressWithDuration:3 andTintColor:[UIColor colorWithRed:0.2 green:0.6 blue:0.8 alpha:1.0]];进度完成回调虽然项目本身没有直接提供完成回调但你可以结合动画完成块来实现[self.navigationController showSGProgressWithDuration:3]; // 3秒后执行完成操作 dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{ // 进度完成后的操作 NSLog(进度完成); }); 性能优化建议避免频繁更新对于百分比模式建议不要过于频繁地调用setSGProgressPercentage:可以适当降低更新频率合理使用遮罩遮罩层会增加视图层级在不需要时尽量避免使用及时清理使用finishSGProgress或cancelSGProgress及时结束进度显示 设计理念总结SGNavigationProgress的成功之处在于其简洁而强大的设计分类设计模式不修改系统类保持代码的纯净性智能视图管理自动查找和重用现有视图提高性能灵活的API提供多种使用方式满足不同场景需求完善的动画流畅的进度动画和渐入渐出效果良好的兼容性支持iOS各种版本和设备旋转 实际应用场景这个库特别适合以下应用场景网络请求进度文件上传/下载的进度展示页面加载指示网页或内容加载时的进度提示表单提交表单数据提交时的进度反馈多步骤操作多步骤流程的进度指示后台任务后台处理任务的进度可视化结语SGNavigationProgress是一个设计精良、使用简单的iOS进度条组件通过深入分析其源码我们不仅学到了如何实现一个优雅的进度指示器更重要的是理解了分类设计模式在实际项目中的应用价值。无论是新手开发者还是有经验的iOS工程师都能从这个项目中获得启发和实用的代码实现思路。通过合理的架构设计和简洁的APISGNavigationProgress为iOS应用提供了专业级的进度指示解决方案值得在需要进度展示功能的应用中采用和借鉴。【免费下载链接】SGNavigationProgressA category for showing a Messages like progress view on a UINavigationBar项目地址: https://gitcode.com/gh_mirrors/sg/SGNavigationProgress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
