5分钟上手UIViewController-KeyboardAnimation：iOS键盘动画类别完全指南

5分钟上手UIViewController-KeyboardAnimationiOS键盘动画类别完全指南【免费下载链接】UIViewController-KeyboardAnimationShowing/dismissing keyboard animation in UIViewController category.项目地址: https://gitcode.com/gh_mirrors/ui/UIViewController-KeyboardAnimationUIViewController-KeyboardAnimation是一个专为 iOS 键盘动画设计的 UIViewController 类别组件只需一行订阅代码它就能监听键盘显示/隐藏通知自动使用系统键盘的动画时长与曲线来驱动你的自定义动画彻底告别繁琐的键盘通知处理。本文带你 5 分钟完成安装与上手 一、它解决什么问题iOS 键盘动画的痛点做过 iOS 开发的朋友都有体会键盘弹出时要顶起输入框、收起时要恢复布局每个页面都要重复写一遍通知监听、解析userInfo里的时长和曲线……大量重复代码稍有不慎动画就和系统键盘脱节了。这个类别把这些脏活全包了✅ 自动订阅UIKeyboardWillShowNotification/UIKeyboardWillHideNotification✅ 自动从通知中提取键盘的最终 frame、动画时长、动画曲线✅ 把你的动画块包裹在UIView.animateWithDuration中与键盘逐帧同步✅ 用极少的代码声明动画一行搞定二、一键安装三种方式任选方式 1CocoaPods推荐在 Podfile 中添加版本 1.3支持 iOS 6.0pod UIViewControllerKeyboardAnimation, ~ 1.3方式 2Git 子模块或克隆源码git clone https://gitcode.com/gh_mirrors/ui/UIViewController-KeyboardAnimation方式 3直接拷贝文件组件核心只有两个文件头文件 实现拷贝进工程即可使用零依赖。安装说明详见 README.md版本信息见 UIViewControllerKeyboardAnimation.podspec。三、三步完成键盘动画订阅聊天输入框场景以最典型的聊天式输入框随键盘顶起为例 第 1 步在 Interface Builder 中给输入框底部与父视图底部建立 Auto Layout 约束并通过IBOutlet引出property (weak, nonatomic) IBOutlet NSLayoutConstraint *chatInputBottomSpace;第 2 步在viewWillAppear中订阅键盘这是官方推荐的最佳时机weakify(self) [self an_subscribeKeyboardWithAnimations:^(CGRect keyboardRect, NSTimeInterval duration, BOOL isShowing) { strongify(self) self.chatInputBottomSpace.constant isShowing ? CGRectGetHeight(keyboardRect) : 0; [self.view layoutIfNeeded]; } completion:nil];第 3 步在viewWillDisappear中退订避免内存泄漏和跨页面误触发[self an_unsubscribeKeyboard];就这样输入框会完全跟随系统键盘的节奏弹出与回落动画时长和曲线由系统自动决定你无需手动配置 ⏱️四、进阶 API更复杂的键盘动画需求简单场景用an_subscribeKeyboardWithAnimations:completion:足够复杂场景如键盘弹出前先做转场、动画结束回调可看下面的方法清单 方法用途an_subscribeKeyboardWithBeforeAnimations:animations:completion:三段式动画前的准备动作 主动画 完成回调an_subscribeKeyboardFrameChangesWithAnimations:响应键盘尺寸变化如方向旋转、输入法切换v1.3 新增an_subscribeKeyboardShowHideWithAnimations:上述方法的别名写法an_unsubscribeKeyboard退订显示/隐藏事件并清空动画块an_unsubscribeKeyboardFrameChanges退订尺寸变化事件完整的 API 签名与参数说明见 UIViewControllerKeyboardAnimation.h。 使用 before 段可以做一些瞬时的准备工作例如 Demo 中在键盘弹出瞬间切换图片与淡入淡出头部视图效果非常自然。可参考 Demo/KeyboardAnimationDemo/ViewController.m 的完整演示。五、工作原理它如何与系统键盘保持同步拆开实现看逻辑非常清晰约 150 行代码适合精读学习订阅阶段an_subscribe...系列方法通过关联对象objc_setAssociatedObject保存你传入的动画块并向NSNotificationCenter注册键盘通知观察者触发阶段键盘通知到达后从userInfo中解析出键盘最终 frameUIKeyboardFrameEndUserInfoKey、时长、曲线三个关键参数动画阶段在UIView.animateWithDuration中先执行 before 块再以系统曲线执行你的主动画块最后回调 completion。核心处理逻辑见 UIViewControllerKeyboardAnimation.m通知解析部分见 UIViewControllerKeyboardAnimation.m。六、新手避坑清单 ⚠️一定要退订如果不退订当前页面消失后它仍会响应键盘事件导致其他屏幕出现莫名其妙的动画警惕循环引用动画块会被持有在 ViewController 上块内请用weakify(self)/strongify(self)依赖 ReactiveCocoa 风格宏也可用__weak等价实现Auto Layout 记得刷新修改约束常量后需调用[self.view layoutIfNeeded]否则动画不生效订阅时机推荐viewWillAppear订阅、viewWillDisappear退订与页面生命周期严格对应。七、项目文件导读文件说明UIViewControllerKeyboardAnimation.h公开 API 与块类型声明UIViewControllerKeyboardAnimation.m完整实现通知监听 动画驱动UIViewControllerKeyboardAnimation.podspecCocoaPods 配置Demo/KeyboardAnimationDemo/ViewController.m可运行的键盘动画 Demo 页面Demo/KeyboardAnimationDemo/Base.lproj/Main.storyboardDemo 界面布局README.md官方说明文档Demo 工程完整目录见 Demo/KeyboardAnimationDemo/打开即可体验键盘弹出时背景色渐变、间距联动等效果。八、常见问题 FAQQ最低支持什么系统版本AiOS 6.0覆盖绝大多数设备。QSwift 工程能用吗A可以。组件以 Objective-C 编写Swift 工程通过桥接头或 Pod 自动集成导入即可直接调用这些类别方法。Q需要其他依赖吗A无强制依赖仅代码示例中使用了 ReactiveCocoa 的weakify/strongify宏可自行替换为原生 weak/strong 写法。Q能同时响应键盘弹出和尺寸变化吗A能。分别调用an_subscribeKeyboardWithAnimations:和an_subscribeKeyboardFrameChangesWithAnimations:即可退订时对应调用各自的 unsubscribe 方法。写在最后5 分钟回顾一下安装 → viewWillAppear 订阅 → 改约束常量 → viewWillDisappear 退订四步就能让任何页面的键盘动画与系统完美同步。整个类别 API 少而精、源码透明既是即插即用的工具也是学习 iOS 键盘通知机制的优质范例。现在就去你的工程里试试吧 【免费下载链接】UIViewController-KeyboardAnimationShowing/dismissing keyboard animation in UIViewController category.项目地址: https://gitcode.com/gh_mirrors/ui/UIViewController-KeyboardAnimation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考