寫 iOS 專案久了,工具箱裡總會慢慢累積一批自己手刻的 Category(類別)。這些小工具看起來不起眼,卻能在日常開發裡省下大量重複勞動。今天就把自己整理的一批常用類目大方分享出來,涵蓋日期格式化、色彩轉換、圖片處理與視圖動畫等常見場景。
每當要格式化日期,我們都得反覆 new 一個 formatter 再設定格式。透過 Category,我們把這些樣板程式碼一次封裝好,之後只要一句話就能取用。
@interface NSDateFormatter (MyCategory) + (id)dateFormatter; + (id)dateFormatterWithFormat:(NSString *)dateFormat; + (id)defaultDateFormatter; @end
@implementation NSDateFormatter (MyCategory)
+ (id)dateFormatter {
return [[self alloc] init];
}
+ (id)dateFormatterWithFormat:(NSString *)dateFormat {
NSDateFormatter *dateFormatter = [[self alloc] init];
dateFormatter.dateFormat = dateFormat;
return dateFormatter;
}
+ (id)defaultDateFormatter {
return [self dateFormatterWithFormat:@"yyyy-MM-dd HH:mm:ss"];
}
@end
「3 分鐘前」「昨天」這類相對時間的顯示,幾乎每個 App 都用得到。下面這組方法能自動把時間差轉換成貼近直覺的中文描述。
@interface NSDate (MyCategory) - (NSString *)timeIntervalDescription;//距離當前的時間間隔 - (NSString *)minuteDescription;//精確到分鐘的日期 - (NSString *)formattedDateDescription;//格式化日期 @end
@implementation NSDate (MyCategory)
- (NSString *)timeIntervalDescription {
NSTimeInterval timeInterval = -[self timeIntervalSinceNow];
if (timeInterval < 60) {
return @"1分鐘內";
} else if (timeInterval < 3600) {
return [NSString stringWithFormat:@"%.f分鐘前", timeInterval / 60];
} else if (timeInterval < 86400) {
return [NSString stringWithFormat:@"%.f小時前", timeInterval / 3600];
} else if (timeInterval < 2592000) {//30天內
return [NSString stringWithFormat:@"%.f天前", timeInterval / 86400];
} else if (timeInterval < 31536000) {//30天至1年內
NSDateFormatter *dateFormatter = [NSDateFormatter dateFormatterWithFormat:@"M月d日"];
return [dateFormatter stringFromDate:self];
} else {
return [NSString stringWithFormat:@"%.f年前", timeInterval / 31536000];
}
}
- (NSString *)minuteDescription {
NSDateFormatter *dateFormatter = [NSDateFormatter dateFormatterWithFormat:@"yyyy-MM-dd"];
NSString *theDay = [dateFormatter stringFromDate:self];//日期的年月日
NSString *currentDay = [dateFormatter stringFromDate:[NSDate date]];//當前年月日
if ([theDay isEqualToString:currentDay]) {//當天
[dateFormatter setDateFormat:@"ah:mm"];
return [dateFormatter stringFromDate:self];
} else if ([[dateFormatter dateFromString:currentDay] timeIntervalSinceDate:[dateFormatter dateFromString:theDay]] == 86400) {//昨天
[dateFormatter setDateFormat:@"ah:mm"];
return [NSString stringWithFormat:@"昨天 %@", [dateFormatter stringFromDate:self]];
} else if ([[dateFormatter dateFromString:currentDay] timeIntervalSinceDate:[dateFormatter dateFromString:theDay]] < 86400 * 7) {//間隔一周內
[dateFormatter setDateFormat:@"EEEE ah:mm"];
return [dateFormatter stringFromDate:self];
} else {//以前
[dateFormatter setDateFormat:@"yyyy-MM-dd ah:mm"];
return [dateFormatter stringFromDate:self];
}
}
- (NSString *)formattedDateDescription {
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setDateFormat:@"yyyy-MM-dd"];
NSString *theDay = [dateFormatter stringFromDate:self];//日期的年月日
NSString *currentDay = [dateFormatter stringFromDate:[NSDate date]];//當前年月日
NSInteger timeInterval = -[self timeIntervalSinceNow];
if (timeInterval < 60) {
return @"1分鐘內";
} else if (timeInterval < 3600) {//1小時內
return [NSString stringWithFormat:@"%d分鐘前", timeInterval / 60];
} else if (timeInterval < 21600) {//6小時內
return [NSString stringWithFormat:@"%d小時前", timeInterval / 3600];
} else if ([theDay isEqualToString:currentDay]) {//當天
[dateFormatter setDateFormat:@"HH:mm"];
return [NSString stringWithFormat:@"今天 %@", [dateFormatter stringFromDate:self]];
} else if ([[dateFormatter dateFromString:currentDay] timeIntervalSinceDate:[dateFormatter dateFromString:theDay]] == 86400) {//昨天
[dateFormatter setDateFormat:@"HH:mm"];
return [NSString stringWithFormat:@"昨天 %@", [dateFormatter stringFromDate:self]];
} else {//以前
[dateFormatter setDateFormat:@"MM-dd HH:mm"];
return [dateFormatter stringFromDate:self];
}
}
@end
設計稿給的是 #RRGGBB 格式的色碼,而 UIColor 卻只吃 RGB 浮點值。這個類目讓我們直接傳入十六進位字串就能拿到對應顏色。
@interface UIColor (MyCategory) + (UIColor *)colorWithHexRGB:(NSString *)hexRGBString; @end
@implementation UIColor (MyCategory)
/*由16進制字符串獲取顏色*/
+ (UIColor *)colorWithHexRGB:(NSString *)hexRGBString {
if ([hexRGBString hasPrefix:@"#"]) {
hexRGBString = [hexRGBString substringFromIndex:1];
}
unsigned int colorCode = 0;
unsigned char redByte, greenByte, blueByte;
if (hexRGBString) {
NSScanner *scanner = [NSScanner scannerWithString:hexRGBString];
[scanner scanHexInt:&colorCode];
}
redByte = (unsigned char) (colorCode >> 16);
greenByte = (unsigned char) (colorCode >> 8);
blueByte = (unsigned char) (colorCode);
return [UIColor colorWithRed:(float)redByte/0xff green:(float)greenByte/0xff blue:(float)blueByte/0xff alpha:1.0];
}
@end
圖片處理是 App 開發的高頻需求。這組方法把拉伸平鋪、ScaleToFit 縮放、方向修正等常見操作全部封裝起來,同時兼顧 iOS 5 以上的相容性。
@interface UIImage (MyCategory) - (UIImage *)resizableImageWithCompatibleCapInsets:(UIEdgeInsets)capInsets resizingMode:(UIImageResizingMode)resizingMode; - (CGSize)sizeOfScaleToFit:(CGSize)scaledSize; - (UIImage *)fixOrientation; - (UIImage *)compressedImageWithSize:(CGSize)compressedSize; @end
@implementation UIImage (MyCategory)
/*獲取當前主題包的指定圖片*/
+ (UIImage *)themeImageNamed:(NSString *)name {
NSUInteger themeID = [[ViewManager defaultManager] themeID];
if (themeID == 0) {//默認主題
NSString *fileName = [NSString stringWithFormat:@"Lianxi.bundle/Images/%@", name];
return [self imageNamed:fileName];
} else {//下載主題
return nil;
}
}
/*圖片拉伸、平鋪接口,兼容iOS5+*/
- (UIImage *)resizableImageWithCompatibleCapInsets:(UIEdgeInsets)capInsets resizingMode:(UIImageResizingMode)resizingMode {
CGFloat version = [[[UIDevice currentDevice] systemVersion] floatValue];
if (version >= 6.0) {
return [self resizableImageWithCapInsets:capInsets resizingMode:resizingMode];
} else if (version >= 5.0) {
if (resizingMode == UIImageResizingModeStretch) {
return [self stretchableImageWithLeftCapWidth:capInsets.left topCapHeight:capInsets.top];
} else {
return [self resizableImageWithCapInsets:capInsets];
}
} else {
return [self stretchableImageWithLeftCapWidth:capInsets.left topCapHeight:capInsets.top];
}
}
/*圖片以ScaleToFit方式拉伸後的CGSize*/
- (CGSize)sizeOfScaleToFit:(CGSize)scaledSize {
CGFloat scaleFactor = scaledSize.width / scaledSize.height;
CGFloat imageFactor = self.size.width / self.size.height;
if (scaleFactor <= imageFactor) {//圖片橫向填充
return CGSizeMake(scaledSize.width, scaledSize.width / imageFactor);
} else {//縱向填充
return CGSizeMake(scaledSize.height * imageFactor, scaledSize.height);
}
}
/*將圖片轉向調整為向上*/
- (UIImage *)fixOrientation {
if (self.imageOrientation == UIImageOrientationUp) {
return self;
}
UIGraphicsBeginImageContextWithOptions(self.size, NO, self.scale);
[self drawInRect:CGRectMake(0.0, 0.0, self.size.width, self.size.height)];
UIImage *fixedImage = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return fixedImage;
}
/*以ScaleToFit方式壓縮圖片*/
- (UIImage *)compressedImageWithSize:(CGSize)compressedSize {
if (CGSizeEqualToSize(self.size, CGSizeZero) || (self.size.width <= compressedSize.width && self.size.height <= compressedSize.height)) {//不用壓縮
return self;
}
CGSize scaledSize = [self sizeOfScaleToFit:compressedSize];
UIGraphicsBeginImageContext(scaledSize);
[self drawInRect:CGRectMake(0.0, 0.0, scaledSize.width, scaledSize.height)];
UIImage *compressedImage = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return compressedImage;
}
@end
最後這組類目為 UIView 加上搖動動畫、360 度旋轉動畫、截圖功能,以及便捷的 top/bottom/left/right 邊距存取器,讓佈局計算更直觀。
@interface UIView (MyCategory) - (void)startShakeAnimation;//搖動動畫 - (void)stopShakeAnimation; - (void)startRotateAnimation;//360°旋轉動畫 - (void)stopRotateAnimation; - (UIImage *)screenshot;//截圖 @property (nonatomic) float top; @property (nonatomic) float bottom; @property (nonatomic) float left; @property (nonatomic) float right; @end
@implementation UIView (MyCategory)
/*截圖*/
- (UIImage *)screenshot {
UIGraphicsBeginImageContextWithOptions(self.frame.size, NO, 2.0);
[self.layer renderInContext:UIGraphicsGetCurrentContext()];
UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return image;
}
#pragma mark - Animation
- (void)startShakeAnimation {
CGFloat rotation = 0.05;
CABasicAnimation *shake = [CABasicAnimation animationWithKeyPath:@"transform"];
shake.duration = 0.2;
shake.autoreverses = YES;
shake.repeatCount = MAXFLOAT;
shake.removedOnCompletion = NO;
shake.fromValue = [NSValue valueWithCATransform3D:CATransform3DRotate(self.layer.transform, -rotation, 0.0, 0.0, 1.0)];
shake.toValue = [NSValue valueWithCATransform3D:CATransform3DRotate(self.layer.transform, rotation, 0.0, 0.0, 1.0)];
[self.layer addAnimation:shake forKey:@"shakeAnimation"];
}
- (void)stopShakeAnimation {
[self.layer removeAnimationForKey:@"shakeAnimation"];
}
- (void)startRotateAnimation {
CABasicAnimation *shake = [CABasicAnimation animationWithKeyPath:@"transform"];
shake.duration = 0.5;
shake.autoreverses = NO;
shake.repeatCount = MAXFLOAT;
shake.removedOnCompletion = NO;
shake.fromValue = [NSValue valueWithCATransform3D:CATransform3DRotate(self.layer.transform, M_PI, 0.0, 0.0, 1.0)];
shake.toValue = [NSValue valueWithCATransform3D:CATransform3DRotate(self.layer.transform, 0.0, 0.0, 0.0, 1.0)];
[self.layer addAnimation:shake forKey:@"rotateAnimation"];
}
- (void)stopRotateAnimation {
[self.layer removeAnimationForKey:@"rotateAnimation"];
}
-(float)top {
return self.frame.origin.x;
}
-(float)bottom {
return self.top+self.frame.size.height;
}
-(float)left {
return self.frame.origin.x;
}
-(float)right {
return self.left+self.frame.size.width;
}
@end
以上就是這批常用類目的完整整理,歡迎按需取用,也歡迎在自己的專案裡持續擴充。