XYOrigami完成回调（completion）实战：动画结束后如何优雅处理业务逻辑

XYOrigami完成回调completion实战动画结束后如何优雅处理业务逻辑【免费下载链接】XYOrigami项目地址: https://gitcode.com/gh_mirrors/xy/XYOrigamiXYOrigami 是一款轻量级的 iOS 折叠转场动画库以 UIView 分类Category的方式提供开箱即用的折纸动画效果而它的完成回调completion机制让开发者可以在动画播放结束的那一刻精准地触发后续业务逻辑。本文将通过实战代码带你掌握 XYOrigami completion 回调的完整用法包括打开/关闭动画的写法、5 个高频应用场景以及 3 个避坑要点彻底告别动画还没播完就开始刷新界面的尴尬体验。一、什么是 XYOrigami 完成回调completionXYOrigami 的核心功能是让任意 UIView 像折纸一样优雅地展示或收起另一块视图。它对外只暴露两个方法showOrigamiTransitionWith:...以折叠动画打开一个视图hideOrigamiTransitionWith:...以折叠动画收起视图。而完成回调completion就是这两个方法末尾的void (^)(BOOL finished)参数当整段折叠动画播放完毕后系统会自动执行你传入的代码块。你可以在里面更新 UI、切换页面状态、记录埋点或发起网络请求。 简单理解动画负责好看completion 回调负责干活。两者配合才能做出真正流畅的交互。二、为什么要用完成回调动画结束后的三大痛点如果没有 completion你只能靠猜测动画时长来写dispatch_after会踩到这些坑痛点后果动画时长不确定定时器早了界面闪烁晚了体验卡顿用户反复触发连续点击导致动画叠加、状态错乱无法感知结束时刻折叠页还没就位就操作它逻辑报错XYOrigami 在源码内部使用CATransaction的完成块来统一收尾并在结束后回调你的代码。相关实现见 UIViewOrigami.m这个设计让动画结束这个事件变得完全可控。三、打开动画的完成回调showOrigamiTransitionWith 实战这是最常用的场景点击按钮后侧边视图折叠展开展开完成的瞬间弹出关闭按钮。参考 Demo 中的写法见 ViewController.m[self.centerView showOrigamiTransitionWith:self.sideView NumberOfFolds:2 Duration:0.5 Direction:XYOrigamiDirectionFromRight completion:^(BOOL finished) { self.closeBtn.hidden NO; // 动画结束后再显示关闭按钮 }];要点解析NumberOfFolds折叠的份数值越大折叠细节越丰富Duration动画总时长单位秒Direction折叠方向支持右、左、上、下四种枚举定义见 UIViewOrigami.hcompletion动画结束后执行参数finished表示动画是否正常完成。四、收起动画的完成回调hideOrigamiTransitionWith 实战收起动画的用法完全对称适合在关闭折叠页时复位 UI 状态[self.centerView hideOrigamiTransitionWith:self.sideView NumberOfFolds:2 Duration:0.5 Direction:XYOrigamiDirectionFromRight completion:^(BOOL finished) { self.closeBtn.hidden YES; [self.sideView removeFromSuperview]; // 收起后再清理视图 }];⚠️ 注意在 Demo 中打开/收起是成对出现的——先show再hide顺序不能乱。因为 XYOrigami 内部维护了转场状态机Idle → Update → Show具体逻辑见 UIViewOrigami.m。五、完成回调的 5 个高频应用场景学会了基础写法再看 completion 到底能做什么️ 控制 UI 显隐动画结束后再显示/隐藏按钮避免画面穿帮 切换页面状态折叠页完全展开后再加载地图、列表等重型内容 数据上报埋点在动画结束时刻记录用户行为数据 重置交互开关动画结束后将是否允许点击的开关复位防止连点 串联下一段动画在一个动画的 completion 中启动另一个动画实现链式转场。其中第 1 点正是官方 Demo 的做法closeBtn只在动画完成后出现见 ViewController.m值得借鉴。六、使用 completion 的 3 个避坑要点新手最容易在这几个地方翻车提前记住避免在回调里直接做耗时操作completion 运行在主线程大计算或同步网络请求会造成掉帧建议异步处理注意循环引用在 Block 中引用self时记得使用弱引用__weak防止控制器无法释放不要依赖参数做过多分支库内部固定回调finished YES见 UIViewOrigami.m业务判断应以你的实际状态为准。七、三步快速上手 XYOrigami想在项目里立刻用上这套动画 completion 机制很简单获取源码git clone https://gitcode.com/gh_mirrors/xy/XYOrigami拖入工程将XYOrigami文件夹拖进 Xcode 工程并添加QuartzCore框架见 XYOrigami/导入头文件#import UIViewOrigami.h即可调用折叠动画与完成回调。整个库只有两个核心文件UIViewOrigami.h 与 UIViewOrigami.m集成成本极低非常适合快速为 App 增加高级的折叠转场体验。【免费下载链接】XYOrigami项目地址: https://gitcode.com/gh_mirrors/xy/XYOrigami创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考