CALayer+QMUI.h
4.21 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/*****
* Tencent is pleased to support the open source community by making QMUI_iOS available.
* Copyright (C) 2016-2019 THL A29 Limited, a Tencent company. All rights reserved.
* Licensed under the MIT License (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
* http://opensource.org/licenses/MIT
* Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
*****/
//
// CALayer+QMUI.h
// qmui
//
// Created by QMUI Team on 16/8/12.
//
#import <UIKit/UIKit.h>
#import <Foundation/Foundation.h>
#import <QuartzCore/QuartzCore.h>
typedef NS_OPTIONS (NSUInteger, QMUICornerMask) {
QMUILayerMinXMinYCorner = 1U << 0,
QMUILayerMaxXMinYCorner = 1U << 1,
QMUILayerMinXMaxYCorner = 1U << 2,
QMUILayerMaxXMaxYCorner = 1U << 3,
};
@interface CALayer (QMUI)
/// 暂停/恢复当前 layer 上的所有动画
@property(nonatomic, assign) BOOL qmui_pause;
/**
* 设置四个角是否支持圆角的，iOS11 及以上会调用系统的接口，否则 QMUI 额外实现
* @warning 如果对应的 layer 有圆角，则请使用 QMUI_Border，否则系统的 border 会被 clip 掉
* @warning 使用 qmui 方法，则超出 layer 范围内的内容都会被 clip 掉，系统的则不会
* @warning 如果使用这个接口设置圆角，那么需要获取圆角的值需要用 qmui_originCornerRadius，否则 iOS 11 以下获取到的都是 0
*/
@property(nonatomic, assign) QMUICornerMask qmui_maskedCorners;
/// iOS11 以下 layer 自身的 cornerRadius 一直都是 0，圆角的是通过 mask 做的，qmui_originCornerRadius 保存了当前的圆角
@property(nonatomic, assign, readonly) CGFloat qmui_originCornerRadius;
/**
* 把某个 sublayer 移动到当前所有 sublayers 的最后面
* @param sublayer 要被移动的 layer
* @warning 要被移动的 sublayer 必须已经添加到当前 layer 上
*/
- (void)qmui_sendSublayerToBack:(CALayer *)sublayer;
/**
* 把某个 sublayer 移动到当前所有 sublayers 的最前面
* @param sublayer 要被移动的layer
* @warning 要被移动的 sublayer 必须已经添加到当前 layer 上
*/
- (void)qmui_bringSublayerToFront:(CALayer *)sublayer;
/**
* 移除 CALayer（包括 CAShapeLayer 和 CAGradientLayer）所有支持动画的属性的默认动画，方便需要一个不带动画的 layer 时使用。
*/
- (void)qmui_removeDefaultAnimations;
/**
* 生成虚线的方法，注意返回的是 CAShapeLayer
* @param lineLength 每一段的线宽
* @param lineSpacing 线之间的间隔
* @param lineWidth 线的宽度
* @param lineColor 线的颜色
* @param isHorizontal 是否横向，因为画虚线的缘故，需要指定横向或纵向，横向是 YES，纵向是 NO。
* 注意：暂不支持 dashPhase 和 dashPattens 数组设置，因为这些都定制性太强，如果用到则自己调用系统方法即可。
*/
+ (CAShapeLayer *)qmui_separatorDashLayerWithLineLength:(NSInteger)lineLength
lineSpacing:(NSInteger)lineSpacing
lineWidth:(CGFloat)lineWidth
lineColor:(CGColorRef)lineColor
isHorizontal:(BOOL)isHorizontal;
/**
* 产生一个通用分隔虚线的 layer，高度为 PixelOne，线宽为 2，线距为 2，默认会移除动画，并且背景色用 UIColorSeparator，注意返回的是 CAShapeLayer。
* 其中，InHorizon 是横向；InVertical 是纵向。
*/
+ (CAShapeLayer *)qmui_separatorDashLayerInHorizontal;
+ (CAShapeLayer *)qmui_separatorDashLayerInVertical;
/**
* 产生一个适用于做通用分隔线的 layer，高度为 PixelOne，默认会移除动画，并且背景色用 UIColorSeparator
*/
+ (CALayer *)qmui_separatorLayer;
/**
* 产生一个适用于做列表分隔线的 layer，高度为 PixelOne，默认会移除动画，并且背景色用 TableViewSeparatorColor
*/
+ (CALayer *)qmui_separatorLayerForTableView;
@end