Skip to content

Commit b35556a

Browse files
zhoonzhoon
committed
Merge commit 'd17d3cabc9d34dced471c29128c8fd4c47f11a53'
2 parents 1127e8a + d17d3ca commit b35556a

20 files changed

Lines changed: 1477 additions & 109 deletions

‎QMUI/QMUIKit.podspec‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Pod::Spec.new do |s|
22
s.name = "QMUIKit"
3-
s.version = "1.4.0"
3+
s.version = "1.5.0"
44
s.summary = "致力于提高项目 UI 开发效率的解决方案"
55
s.description = <<-DESC
66
QMUI iOS 是一个致力于提高项目 UI 开发效率的解决方案，其设计目的是用于辅助快速搭建一个具备基本设计还原效果的 iOS 项目，同时利用自身提供的丰富控件及兼容处理， 让开发者能专注于业务需求而无需耗费精力在基础代码的设计上。不管是新项目的创建，或是已有项目的维护，均可使开发效率和项目质量得到大幅度提升。

‎QMUI/QMUIKit/QMUIKit.h‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,8 @@
4141
#import "UILabel+QMUI.h"
4242
#import "UIImageView+QMUI.h"
4343
#import "UIControl+QMUI.h"
44+
#import "UITextField+QMUI.h"
45+
#import "UITextView+QMUI.h"
4446
#import "UIButton+QMUI.h"
4547
#import "UISearchBar+QMUI.h"
4648
#import "UIScrollView+QMUI.h"
@@ -57,6 +59,7 @@
5759
#import "UINavigationController+NavigationBarTransition.h"
5860

5961
/// UIComponents
62+
#import "QMUIKeyboardManager.h"
6063
#import "QMUIToastBackgroundView.h"
6164
#import "QMUIToastContentView.h"
6265
#import "QMUIToastAnimator.h"

‎QMUI/QMUIKit/UICommon/QMUICommonDefines.h‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -155,10 +155,10 @@
155155
#define PixelOne [QMUIHelper pixelOne]
156156

157157
// 获取最合适的适配值，默认以varFor55Inch为准，也即偏向大屏
158-
#define PreferredVarForDevices(varFor55Inch, varFor47Inch, varFor40Inch, var4) (IS_35INCH_SCREEN ? var4 : (IS_40INCH_SCREEN ? varFor40Inch : (IS_47INCH_SCREEN ? varFor47Inch : varFor55Inch)))
158+
#define PreferredVarForDevices(varFor55Inch, varFor47Inch, varFor40Inch, varFor35Inch) (IS_35INCH_SCREEN ? varFor35Inch : (IS_40INCH_SCREEN ? varFor40Inch : (IS_47INCH_SCREEN ? varFor47Inch : varFor55Inch)))
159159

160160
// 同上，加多一个iPad的参数
161-
#define PreferredVarForUniversalDevices(varForPad, varFor55Inch, varFor47Inch, varFor40Inch, var4) (IS_IPAD ? varForPad :(IS_55INCH_SCREEN ? varFor55Inch : (IS_47INCH_SCREEN ? varFor47Inch : (IS_40INCH_SCREEN ? varFor40Inch : var4))))
161+
#define PreferredVarForUniversalDevices(varForPad, varFor55Inch, varFor47Inch, varFor40Inch, varFor35Inch) (IS_IPAD ? varForPad :(IS_55INCH_SCREEN ? varFor55Inch : (IS_47INCH_SCREEN ? varFor47Inch : (IS_40INCH_SCREEN ? varFor40Inch : varFor35Inch))))
162162

163163

164164
#pragma mark - 方法-创建器
@@ -515,4 +515,3 @@ CGRectSetSize(CGRect rect, CGSize size) {
515515
rect.size = CGSizeFlatted(size);
516516
return rect;
517517
}
518-

‎QMUI/QMUIKit/UIComponents/QMUIKeyboardManager.h‎

Lines changed: 202 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,202 @@
1+
//
2+
// QMUIKeyboardManager.h
3+
// qmui
4+
//
5+
// Created by zhoonchen on 2017/3/23.
6+
// Copyright © 2017年 QMUI Team. All rights reserved.
7+
//
8+
9+
#import <Foundation/Foundation.h>
10+
#import <UIKit/UIKit.h>
11+
12+
@class QMUIKeyboardUserInfo;
13+
@class QMUIKeyboardManager;
14+
15+
16+
/**
17+
* `QMUIKeyboardManagerDelegate`里面的方法是对应系统键盘通知的回调方法，具体请看delegate名字，`QMUIKeyboardUserInfo`是对系统的userInfo做了一个封装，可以方便的获取userInfo的属性值。
18+
*/
19+
@protocol QMUIKeyboardManagerDelegate <NSObject>
20+
21+
@optional
22+
23+
/**
24+
* 键盘即将显示
25+
*/
26+
- (void)keyboardWillShowWithUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo;
27+
28+
/**
29+
* 键盘即将隐藏
30+
*/
31+
- (void)keyboardWillHideWithUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo;
32+
33+
/**
34+
* 键盘frame即将发生变化。
35+
* 这个delegate除了对应系统的willChangeFrame通知外，在iPad下还增加了监听键盘frame变化的KVO来处理浮动键盘，所以调用次数会比系统默认多。需要让界面或者某个view跟随键盘运动，建议在这个通知delegate里面实现，因为willShow和willHide在手机上是准确的，但是在iPad的浮动键盘下是不准确的。另外，如果不需要跟随浮动键盘运动，那么在逻辑代码里面可以通过判断键盘的位置来过滤这种浮动的情况。
36+
*/
37+
- (void)keyboardWillChangeFrameWithUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo;
38+
39+
/**
40+
* 键盘已经显示
41+
*/
42+
- (void)keyboardDidShowWithUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo;
43+
44+
/**
45+
* 键盘已经隐藏
46+
*/
47+
- (void)keyboardDidHideWithUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo;
48+
49+
/**
50+
* 键盘frame已经发生变化。
51+
*/
52+
- (void)keyboardDidChangeFrameWithUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo;
53+
54+
@end
55+
56+
57+
@interface QMUIKeyboardUserInfo : NSObject
58+
59+
/**
60+
* 所在的KeyboardManager
61+
*/
62+
@property(nonatomic, weak, readonly) QMUIKeyboardManager *keyboardManager;
63+
64+
/**
65+
* 当前键盘的notification
66+
*/
67+
@property(nonatomic, strong, readonly) NSNotification *notification;
68+
69+
/**
70+
* notification自带的userInfo
71+
*/
72+
@property(nonatomic, strong, readonly) NSDictionary *originUserInfo;
73+
74+
/**
75+
* 触发键盘事件的UIResponder
76+
*/
77+
@property(nonatomic, weak, readonly) UIResponder *targetResponder;
78+
79+
/**
80+
* 获取键盘实际宽度
81+
*/
82+
@property(nonatomic, assign, readonly) CGFloat width;
83+
84+
/**
85+
* 获取键盘的实际高度
86+
*/
87+
@property(nonatomic, assign, readonly) CGFloat height;
88+
89+
/**
90+
* 获取当前键盘在view上的可见高度，也就是键盘和view重叠的高度。如果view=nil，则直接返回键盘的实际高度。
91+
*/
92+
- (CGFloat)heightInView:(UIView *)view;
93+
94+
/**
95+
* 获取键盘beginFrame
96+
*/
97+
@property(nonatomic, assign, readonly) CGRect beginFrame;
98+
99+
/**
100+
* 获取键盘endFrame
101+
*/
102+
@property(nonatomic, assign, readonly) CGRect endFrame;
103+
104+
/**
105+
* 获取键盘出现动画的duration，对于第三方键盘，这个值有可能为0
106+
*/
107+
@property(nonatomic, assign, readonly) NSTimeInterval animationDuration;
108+
109+
/**
110+
* 获取键盘动画的Curve参数
111+
*/
112+
@property(nonatomic, assign, readonly) UIViewAnimationCurve animationCurve;
113+
114+
/**
115+
* 获取键盘动画的Options参数
116+
*/
117+
@property(nonatomic, assign, readonly) UIViewAnimationOptions animationOptions;
118+
119+
@end
120+
121+
122+
/**
123+
* `QMUIKeyboardManager`提供了方便管理键盘事件的方案，使用的场景是需要跟随键盘的显示或者隐藏来更改界面的UI原生，例如键盘顶部跟随一个输入框。
124+
* 由于键盘通知的全局性，经常会遇到一个地方的键盘监听回调接响应了其他界面或者控件触发的键盘通知，这样的情况往往不是我们想要的，即使可以通过一些其他的方法来避免，但还是不能完美的解决问题或者有时候解决起来非常麻烦。`QMUIKeyboardManager`通过`delegateEnabled`和`targetResponder`等增强功能属性来方便的控制响应的对象，从而可以实现某个键盘监听回调方法只响应某个UIResponder或者某几个UIResponder触发的键盘通知。
125+
*/
126+
@interface QMUIKeyboardManager : NSObject
127+
128+
/**
129+
* 获取delegate
130+
*/
131+
@property(nonatomic, weak, readonly) id <QMUIKeyboardManagerDelegate> delegate;
132+
133+
/**
134+
* 是否允许触发delegate的回调，用来某些场景直接关闭某些界面或者控件里面的键盘回调来临时禁止接受键盘通知事件。默认YES
135+
*/
136+
@property(nonatomic, assign) BOOL delegateEnabled;
137+
138+
/**
139+
* 添加触发键盘事件的UIResponder，一般是UITextView或者UITextField，没有targetResponder则默认接受任何UIResponder产生的键盘通知。添加成功将会返回YES，否则返回NO。
140+
*/
141+
- (BOOL)addTargetResponder:(UIResponder *)targetResponder;
142+
143+
/**
144+
* 获取当前所有的 target UIResponder
145+
*/
146+
- (NSMutableArray <UIResponder *> *)targetResponders;
147+
148+
/**
149+
* 唯一初始化方法
150+
*/
151+
- (instancetype)initWithDelegate:(id <QMUIKeyboardManagerDelegate>)delegate NS_DESIGNATED_INITIALIZER;
152+
153+
/**
154+
* 把键盘的rect转为相对于view的rect。一般用来把键盘的rect转化为相对于当前self.view的rect，然后获取y值来布局跟随在键盘上的输入框等等（这里一般不要获取键盘的高度，因为对于iPad的键盘，浮动状态下键盘的高度往往不是我们想要的）。
155+
* @param rect 键盘的rect，一般拿keyboardUserInfo.endFrame
156+
* @param view 一个特定的view或者window，如果传入nil则相对有当前的 mainWindow
157+
*/
158+
+ (CGRect)convertKeyboardRect:(CGRect)rect toView:(UIView *)view;
159+
160+
/**
161+
* 获取键盘到顶部到相对于view底部的距离，这个值在某些情况下会等于endFrame.size.height或者visiableKeyboardHeight，不过在iPad浮动键盘的时候就包括了底部的空隙。所以建议使用这个方法。
162+
*/
163+
+ (CGFloat)distanceFromMinYToBottomInView:(UIView *)view keyboardRect:(CGRect)rect;
164+
165+
/**
166+
* 根据键盘的动画参数自己构建一个动画，调用者只需要设置view的位置即可
167+
*/
168+
+ (void)animateWithAnimated:(BOOL)animated keyboardUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo animations:(void (^)(void))animations completion:(void (^)(BOOL finished))completion;
169+
170+
/**
171+
* 这个方法特殊处理 iPad Pro 外接键盘的情况。使用外接键盘在完全不显示键盘的时候，不会调用willShow的通知，所以导致一些通过willShow回调来显示targetResponder的场景（例如微信朋友圈的评论输入框）无法把targetResponder正常的显示出来。通过这个方法，你只需要关心你的show和hide的状态就好了，不需要关心是否 iPad Pro 的情况。
172+
* @param showBlock 键盘显示回调的block，不能把showBlock理解为系统的show通知，而是你有输入框聚焦了并且期望键盘显示出来。
173+
* @param hideBlock 键盘隐藏回调的block，不能把hideBlock理解为系统的hide通知，而是键盘即将消失在界面上并且你期望跟随键盘变化的UI回到默认状态。
174+
*/
175+
+ (void)handleKeyboardNotificationWithUserInfo:(QMUIKeyboardUserInfo *)keyboardUserInfo showBlock:(void (^)(QMUIKeyboardUserInfo *keyboardUserInfo))showBlock hideBlock:(void (^)(QMUIKeyboardUserInfo *keyboardUserInfo))hideBlock;
176+
177+
/**
178+
* 键盘面板的私有view，可能为nil
179+
*/
180+
+ (UIView *)keyboardView;
181+
182+
/**
183+
* 键盘面板所在的私有window，可能为nil
184+
*/
185+
+ (UIWindow *)keyboardWindow;
186+
187+
/**
188+
* 是否有键盘在显示
189+
*/
190+
+ (BOOL)isKeyboardVisible;
191+
192+
/**
193+
* 当期那键盘相对于屏幕的frame
194+
*/
195+
+ (CGRect)currentKeyboardFrame;
196+
197+
/**
198+
* 当前键盘高度键盘的可见高度
199+
*/
200+
+ (CGFloat)visiableKeyboardHeight;
201+
202+
@end

0 commit comments

Comments
 (0)