@aks-dev/easyui 1.0.31 → 1.0.34

package/ios/libs/SDAutoLayout/UIView+SDAutoLayout.h

@@ -0,0 +1,484 @@
+//
+//  UIView+SDAutoLayout.h
+//
+//  Created by gsd on 15/10/6.
+//  Copyright (c) 2015年 gsd. All rights reserved.
+//
+
+/*
+ *************************************************************************
+ 
+ --------- INTRODUCTION ---------
+ 
+ USAGE:
+ 
+ MODE 1. >>>>>>>>>>>>>>> You can use it in this way:
+ 
+ Demo.sd_layout
+ .topSpaceToView(v1, 100)
+ .bottomSpaceToView(v3, 100)
+ .leftSpaceToView(v0, 150)
+ .rightSpaceToView(v2, 150);
+ 
+ MODE 2. >>>>>>>>>>>>>>> You can also use it in this way that is more brevity:
+ 
+ Demo.sd_layout.topSpaceToView(v1, 100).bottomSpaceToView(v3, 100).leftSpaceToView(v0, 150).rightSpaceToView(v2, 150);
+ 
+ 
+ *************************************************************************
+ */
+
+
+/*
+ 
+ *********************************************************************************
+ *
+ * 在您使用此自动布局库的过程中如果出现bug请及时以以下任意一种方式联系我们，我们会及时修复bug并
+ * 帮您解决问题。
+ * QQ    : 2689718696(gsdios)
+ * Email : gsdios@126.com
+ * GitHub: https://github.com/gsdios
+ * 新浪微博:GSD_iOS
+ *
+ * 视频教程：http://www.letv.com/ptv/vplay/24038772.html
+ * 用法示例：https://github.com/gsdios/SDAutoLayout/blob/master/README.md
+ *
+ *********************************************************************************
+ 
+ 
+ SDAutoLayout
+ 版本：2.1.7
+ 发布：2016.08.12
+ 
+ */
+
+
+// 如果需要用“断言”调试程序请打开此宏
+
+//#define SDDebugWithAssert
+
+#import <UIKit/UIKit.h>
+
+@class SDAutoLayoutModel, SDUIViewCategoryManager;
+
+typedef SDAutoLayoutModel *(^MarginToView)(id viewOrViewsArray, CGFloat value);
+typedef SDAutoLayoutModel *(^Margin)(CGFloat value);
+typedef SDAutoLayoutModel *(^MarginEqualToView)(UIView *toView);
+typedef SDAutoLayoutModel *(^WidthHeight)(CGFloat value);
+typedef SDAutoLayoutModel *(^WidthHeightEqualToView)(UIView *toView, CGFloat ratioValue);
+typedef SDAutoLayoutModel *(^AutoHeightWidth)(CGFloat ratioValue);
+typedef SDAutoLayoutModel *(^SameWidthHeight)(void);
+typedef SDAutoLayoutModel *(^Offset)(CGFloat value);
+typedef void (^SpaceToSuperView)(UIEdgeInsets insets);
+
+@interface SDAutoLayoutModel : NSObject
+
+/*
+ *************************说明************************
+ 
+ 方法名中带有“SpaceToView”的需要传递2个参数：（UIView）参照view 和 （CGFloat）间距数值
+ 方法名中带有“RatioToView”的需要传递2个参数：（UIView）参照view 和 （CGFloat）倍数
+ 方法名中带有“EqualToView”的需要传递1个参数：（UIView）参照view
+ 方法名中带有“Is”的需要传递1个参数：（CGFloat）数值
+ 
+ *****************************************************
+ */
+
+
+/* 设置距离其它view的间距 */
+
+/** 左边到其参照view之间的间距，参数为“(View 或者 view数组, CGFloat)”  */
+@property (nonatomic, copy, readonly) MarginToView leftSpaceToView;
+/** 右边到其参照view之间的间距，参数为“(View, CGFloat)”  */
+@property (nonatomic, copy, readonly) MarginToView rightSpaceToView;
+/** 顶部到其参照view之间的间距，参数为“(View 或者 view数组, CGFloat)”  */
+@property (nonatomic, copy, readonly) MarginToView topSpaceToView;
+/** 底部到其参照view之间的间距，参数为“(View, CGFloat)”  */
+@property (nonatomic, copy, readonly) MarginToView bottomSpaceToView;
+
+
+
+/* 设置x、y、width、height、centerX、centerY 值 */
+
+/** x值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) Margin xIs;
+/** y值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) Margin yIs;
+/** centerX值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) Margin centerXIs;
+/** centerY值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) Margin centerYIs;
+/** 宽度值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) WidthHeight widthIs;
+/** 高度值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) WidthHeight heightIs;
+
+
+
+/* 设置最大宽度和高度、最小宽度和高度 */
+
+/** 最大宽度值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) WidthHeight maxWidthIs;
+/** 最大高度值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) WidthHeight maxHeightIs;
+/** 最小宽度值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) WidthHeight minWidthIs;
+/** 最小高度值，参数为“(CGFloat)”  */
+@property (nonatomic, copy, readonly) WidthHeight minHeightIs;
+
+
+
+/* 设置和某个参照view的边距相同 */
+
+/** 左间距与参照view相同，参数为“(View)”  */
+@property (nonatomic, copy, readonly) MarginEqualToView leftEqualToView;
+/** 右间距与参照view相同，参数为“(View)”  */
+@property (nonatomic, copy, readonly) MarginEqualToView rightEqualToView;
+/** 顶部间距与参照view相同，参数为“(View)”  */
+@property (nonatomic, copy, readonly) MarginEqualToView topEqualToView;
+/** 底部间距与参照view相同，参数为“(View)”  */
+@property (nonatomic, copy, readonly) MarginEqualToView bottomEqualToView;
+/** centerX与参照view相同，参数为“(View)”  */
+@property (nonatomic, copy, readonly) MarginEqualToView centerXEqualToView;
+/** centerY与参照view相同，参数为“(View)”  */
+@property (nonatomic, copy, readonly) MarginEqualToView centerYEqualToView;
+
+
+
+/*  设置宽度或者高度等于参照view的多少倍 */
+
+/** 宽度是参照view宽度的多少倍，参数为“(View, CGFloat)” */
+@property (nonatomic, copy, readonly) WidthHeightEqualToView widthRatioToView;
+/** 高度是参照view高度的多少倍，参数为“(View, CGFloat)” */
+@property (nonatomic, copy, readonly) WidthHeightEqualToView heightRatioToView;
+/** 设置一个view的宽度和它的高度相同，参数为空“()” */
+@property (nonatomic, copy, readonly) SameWidthHeight widthEqualToHeight;
+/** 设置一个view的高度和它的宽度相同，参数为空“()” */
+@property (nonatomic, copy, readonly) SameWidthHeight heightEqualToWidth;
+/** 自适应高度，传入高宽比值，label可以传0实现文字高度自适应 */
+@property (nonatomic, copy, readonly) AutoHeightWidth autoHeightRatio;
+
+/** 自适应宽度，参数为宽高比值 */
+@property (nonatomic, copy, readonly) AutoHeightWidth autoWidthRatio;
+
+
+
+/* 填充父view(快捷方法) */
+
+/** 传入UIEdgeInsetsMake(top, left, bottom, right)，可以快捷设置view到其父view上左下右的间距  */
+@property (nonatomic, copy, readonly) SpaceToSuperView spaceToSuperView;
+
+/** 设置偏移量，参数为“(CGFloat value)，目前只有带有equalToView的方法可以设置offset” */
+@property (nonatomic, copy, readonly) Offset offset;
+
+@property (nonatomic, weak) UIView *needsAutoResizeView;
+
+@end
+
+
+
+#pragma mark - UIView 高度、宽度自适应相关方法
+
+@interface UIView (SDAutoHeightWidth)
+
+/** 设置Cell的高度自适应，也可用于设置普通view内容高度自适应 */
+- (void)setupAutoHeightWithBottomView:(UIView *)bottomView bottomMargin:(CGFloat)bottomMargin;
+
+/** 用于设置普通view内容宽度自适应 */
+- (void)setupAutoWidthWithRightView:(UIView *)rightView rightMargin:(CGFloat)rightMargin;
+
+/** 设置Cell的高度自适应，也可用于设置普通view内容自适应（应用于当你不确定哪个view在自动布局之后会排布在最下方最为bottomView的时候可以调用次方法将所有可能在最下方的view都传过去） */
+- (void)setupAutoHeightWithBottomViewsArray:(NSArray *)bottomViewsArray bottomMargin:(CGFloat)bottomMargin;
+
+/** 更新布局（主动刷新布局，如果你需要设置完布局代码就获得view的frame请调用此方法） */
+- (void)updateLayout;
+
+/** 更新cell内部的控件的布局（cell内部控件专属的更新约束方法,如果启用了cell frame缓存则会自动清除缓存再更新约束） */
+- (void)updateLayoutWithCellContentView:(UIView *)cellContentView;
+
+/** 清空高度自适应设置  */
+- (void)clearAutoHeigtSettings;
+
+/** 清空宽度自适应设置  */
+- (void)clearAutoWidthSettings;
+
+@property (nonatomic) CGFloat autoHeight;
+
+@property (nonatomic, readonly) SDUIViewCategoryManager *sd_categoryManager;
+
+@property (nonatomic, readonly) NSMutableArray *sd_bottomViewsArray;
+@property (nonatomic) CGFloat sd_bottomViewBottomMargin;
+
+@property (nonatomic) NSArray *sd_rightViewsArray;
+@property (nonatomic) CGFloat sd_rightViewRightMargin;
+
+@end
+
+
+
+#pragma mark - UIView 设置圆角半径、自动布局回调block等相关方法
+
+@interface UIView (SDLayoutExtention)
+
+/** 自动布局完成后的回调block，可以在这里获取到view的真实frame  */
+@property (nonatomic) void (^didFinishAutoLayoutBlock)(CGRect frame);
+
+/** 添加一组子view  */
+- (void)sd_addSubviews:(NSArray *)subviews;
+
+/* 设置圆角 */
+
+/** 设置圆角半径值  */
+@property (nonatomic, strong) NSNumber *sd_cornerRadius;
+/** 设置圆角半径值为view宽度的多少倍  */
+@property (nonatomic, strong) NSNumber *sd_cornerRadiusFromWidthRatio;
+/** 设置圆角半径值为view高度的多少倍  */
+@property (nonatomic, strong) NSNumber *sd_cornerRadiusFromHeightRatio;
+
+/** 设置等宽子view（子view需要在同一水平方向） */
+@property (nonatomic, strong) NSArray *sd_equalWidthSubviews;
+
+@end
+
+
+
+#pragma mark - UIView 九宫格浮动布局效果
+
+@interface UIView (SDAutoFlowItems)
+
+/** 
+ * 设置类似collectionView效果的固定间距自动宽度浮动子view 
+ * viewsArray       : 需要浮动布局的所有视图
+ * perRowItemsCount : 每行显示的视图个数
+ * verticalMargin   : 视图之间的垂直间距
+ * horizontalMargin : 视图之间的水平间距
+ * vInset           : 上下缩进值
+ * hInset           : 左右缩进值
+ */
+- (void)setupAutoWidthFlowItems:(NSArray *)viewsArray withPerRowItemsCount:(NSInteger)perRowItemsCount verticalMargin:(CGFloat)verticalMargin horizontalMargin:(CGFloat)horizontalMagin verticalEdgeInset:(CGFloat)vInset horizontalEdgeInset:(CGFloat)hInset;
+
+/** 清除固定间距自动宽度浮动子view设置 */
+- (void)clearAutoWidthFlowItemsSettings;
+
+/** 
+ * 设置类似collectionView效果的固定宽带自动间距浮动子view 
+ * viewsArray       : 需要浮动布局的所有视图
+ * perRowItemsCount : 每行显示的视图个数
+ * verticalMargin   : 视图之间的垂直间距
+ * vInset           : 上下缩进值
+ * hInset           : 左右缩进值
+ */
+- (void)setupAutoMarginFlowItems:(NSArray *)viewsArray withPerRowItemsCount:(NSInteger)perRowItemsCount itemWidth:(CGFloat)itemWidth verticalMargin:(CGFloat)verticalMargin verticalEdgeInset:(CGFloat)vInset horizontalEdgeInset:(CGFloat)hInset;
+
+/** 清除固定宽带自动间距浮动子view设置 */
+- (void)clearAutoMarginFlowItemsSettings;
+
+@end
+
+
+
+#pragma mark - UIView 设置约束、更新约束、清空约束、从父view移除并清空约束、开启cell的frame缓存等相关方法
+
+@interface UIView (SDAutoLayout)
+
+/** 开始自动布局  */
+- (SDAutoLayoutModel *)sd_layout;
+
+/** 清空之前的自动布局设置，重新开始自动布局(重新生成布局约束并使其在父view的布局序列数组中位置保持不变)  */
+- (SDAutoLayoutModel *)sd_resetLayout;
+
+/** 清空之前的自动布局设置，重新开始自动布局(重新生成布局约束并添加到父view布局序列数组中的最后一个位置)  */
+- (SDAutoLayoutModel *)sd_resetNewLayout;
+
+/** 是否关闭自动布局  */
+@property (nonatomic, getter = sd_isClosingAutoLayout) BOOL sd_closeAutoLayout;
+
+/** 从父view移除并清空约束  */
+- (void)removeFromSuperviewAndClearAutoLayoutSettings;
+
+/** 清空之前的自动布局设置  */
+- (void)sd_clearAutoLayoutSettings;
+
+/** 将自身frame清零（一般在cell内部控件重用前调用）  */
+- (void)sd_clearViewFrameCache;
+
+/** 将自己的需要自动布局的subviews的frame(或者frame缓存)清零  */
+- (void)sd_clearSubviewsAutoLayoutFrameCaches;
+
+/** 设置固定宽度保证宽度不在自动布局过程再做中调整  */
+@property (nonatomic, strong) NSNumber *fixedWidth;
+
+/** 设置固定高度保证高度不在自动布局过程中再做调整  */
+@property (nonatomic, strong) NSNumber *fixedHeight;
+
+/** 启用cell frame缓存（可以提高cell滚动的流畅度, 目前为cell专用方法，后期会扩展到其他view） */
+- (void)useCellFrameCacheWithIndexPath:(NSIndexPath *)indexPath tableView:(UITableView *)tableview;
+
+/** 所属tableview（目前为cell专用属性，后期会扩展到其他view） */
+@property (nonatomic) UITableView *sd_tableView;
+
+/** cell的indexPath（目前为cell专用属性，后期会扩展到cell的其他子view） */
+@property (nonatomic) NSIndexPath *sd_indexPath;
+
+- (NSMutableArray *)autoLayoutModelsArray;
+- (void)addAutoLayoutModel:(SDAutoLayoutModel *)model;
+@property (nonatomic) SDAutoLayoutModel *ownLayoutModel;
+@property (nonatomic, strong) NSNumber *sd_maxWidth;
+@property (nonatomic, strong) NSNumber *autoHeightRatioValue;
+@property (nonatomic, strong) NSNumber *autoWidthRatioValue;
+
+@end
+
+
+
+#pragma mark - UIScrollView 内容竖向自适应、内容横向自适应方法
+
+@interface UIScrollView (SDAutoContentSize)
+
+/** 设置scrollview内容竖向自适应 */
+- (void)setupAutoContentSizeWithBottomView:(UIView *)bottomView bottomMargin:(CGFloat)bottomMargin;
+
+/** 设置scrollview内容横向自适应 */
+- (void)setupAutoContentSizeWithRightView:(UIView *)rightView rightMargin:(CGFloat)rightMargin;
+
+@end
+
+
+
+#pragma mark - UILabel 开启富文本布局、设置单行文本label宽度自适应、 设置label最多可以显示的行数
+
+@interface UILabel (SDLabelAutoResize)
+
+/** 是否是attributedString */
+@property (nonatomic) BOOL isAttributedContent;
+
+/** 设置单行文本label宽度自适应 */
+- (void)setSingleLineAutoResizeWithMaxWidth:(CGFloat)maxWidth;
+
+/** 设置label最多可以显示多少行，如果传0则显示所有行文字 */
+- (void)setMaxNumberOfLinesToShow:(NSInteger)lineCount;
+
+@end
+
+
+
+#pragma mark - UIButton 设置button根据单行文字自适应
+
+@interface UIButton (SDExtention)
+
+/*
+ * 设置button根据单行文字自适应
+ * hPadding：左右边距
+ */
+- (void)setupAutoSizeWithHorizontalPadding:(CGFloat)hPadding buttonHeight:(CGFloat)buttonHeight;
+
+@end
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+#pragma mark - 其他方法（如果有需要可以自己利用以下接口拓展更多功能）
+
+@interface SDAutoLayoutModelItem : NSObject
+
+@property (nonatomic, strong) NSNumber *value;
+@property (nonatomic, weak) UIView *refView;
+@property (nonatomic, assign) CGFloat offset;
+@property (nonatomic, strong) NSArray *refViewsArray;
+
+@end
+
+
+@interface UIView (SDChangeFrame)
+
+@property (nonatomic) BOOL shouldReadjustFrameBeforeStoreCache;
+
+@property (nonatomic) CGFloat left_sd;
+@property (nonatomic) CGFloat top_sd;
+@property (nonatomic) CGFloat right_sd;
+@property (nonatomic) CGFloat bottom_sd;
+@property (nonatomic) CGFloat centerX_sd;
+@property (nonatomic) CGFloat centerY_sd;
+
+@property (nonatomic) CGFloat width_sd;
+@property (nonatomic) CGFloat height_sd;
+
+
+@property (nonatomic) CGPoint origin_sd;
+@property (nonatomic) CGSize size_sd;
+
+
+// 兼容旧版本
+@property (nonatomic) CGFloat left;
+@property (nonatomic) CGFloat top;
+@property (nonatomic) CGFloat right;
+@property (nonatomic) CGFloat bottom;
+@property (nonatomic) CGFloat centerX;
+@property (nonatomic) CGFloat centerY;
+@property (nonatomic) CGFloat width;
+@property (nonatomic) CGFloat height;
+@property (nonatomic) CGPoint origin;
+@property (nonatomic) CGSize size;
+
+@end
+
+
+@interface SDUIViewCategoryManager : NSObject
+
+@property (nonatomic, strong) NSArray *rightViewsArray;
+@property (nonatomic, assign) CGFloat rightViewRightMargin;
+
+@property (nonatomic, weak) UITableView *sd_tableView;
+@property (nonatomic, strong) NSIndexPath *sd_indexPath;
+
+@property (nonatomic, assign) BOOL hasSetFrameWithCache;
+
+@property (nonatomic) BOOL shouldReadjustFrameBeforeStoreCache;
+
+@property (nonatomic, assign, getter = sd_isClosingAutoLayout) BOOL sd_closeAutoLayout;
+
+
+/** 设置类似collectionView效果的固定间距自动宽度浮动子view */
+
+@property (nonatomic, strong) NSArray *flowItems;
+@property (nonatomic, assign) CGFloat verticalMargin;
+@property (nonatomic, assign) CGFloat horizontalMargin;
+@property (nonatomic, assign) NSInteger perRowItemsCount;
+@property (nonatomic, assign) CGFloat lastWidth;
+
+
+/** 设置类似collectionView效果的固定宽带自动间距浮动子view */
+
+@property (nonatomic, assign) CGFloat flowItemWidth;
+@property (nonatomic, assign) BOOL shouldShowAsAutoMarginViews;
+
+
+@property (nonatomic) CGFloat horizontalEdgeInset;
+@property (nonatomic) CGFloat verticalEdgeInset;
+
+@end
+