前言

block 的妙用：结合block和方法的优点实现iOS的链式编程

-【完整pod 仓库源码GitHub】

主要针对段落样式NSMutableParagraphStyle和富文本NSMutableAttributedString进行封装

代码效果

    xx.kn_addString(@"封装富文本API").kn_fontColor(UIColor.redColor).kn_addString(@"采用block实现链式编程").kn_fontColor(UIColor.blueColor).kn_addString(@"!");

核心思想

实现步骤：方法的返回值是block,block必须有返回值（本身对象），block参数（需要操作的值）
链式编程特点：将多个操作（多行代码）通过点号(.)链接在一起成为一句代码,使代码可读性好a(1).b(2).c(3)。

具体的实现步骤

声明block属性

k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_addString)// 好处是Xcode的提示比较友好
//- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString// 不推荐直接声明getter方法，推荐上面的声明的block属性

实现getter方法

- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString{
    return ^id(NSString *str){
        NSMutableAttributedString *attStr = [[NSMutableAttributedString alloc]initWithString:str];
        self.leftStr = str;
        [self appendAttributedString:attStr];
        return self;
    };
}
1

I 、使用方法

Installation

pod 'ChainAttributedString'

声明

//#import <ChainAttributedString/ChainAttributedString-umbrella.h>
#import <ChainAttributedString/NSMutableAttributedString+Chain.h>

demo

UILabel *x = [UILabel new];
    x.textAlignment = NSTextAlignmentCenter;
    [self.view addSubview:x];
    x.frame = self.view.frame;
    x.numberOfLines = 0;
    NSMutableAttributedString *xx  = [[NSMutableAttributedString alloc]init];
    xx.kn_addString(@"封装富文本API").kn_fontColor(UIColor.redColor).kn_addString(@"采用block实现链式编程").kn_fontColor(UIColor.blueColor).kn_addString(@"!");
    x.attributedText =xx;

II、实现细节

2.1 使用宏进行block属性的声明

#define k_PropertyStatement(propertyModifier,className, propertyPointerType, propertyName) \
@property (nonatomic, propertyModifier) className *(^propertyName)(propertyPointerType);
- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString; 直接声明方法也行
#define k_methodStatement(returnClassName,paramPointerType, methodName) \
- (returnClassName * _Nonnull (^)(paramPointerType * _Nonnull))methodName;

2.2 代码

NSMutableAttributedString+Chain.h

// block 的妙用：结合block和方法的优点实现iOS的链式编程
//其他更多链式编程的例子：https://github.com/zhangkn/DKUsingblockImplementChainProgramming
/**
 核心思想
 */
//核心的实现步骤：方法的返回值是block,block必须有返回值（本身对象），block参数（需要操作的值）
//链式编程特点:将多个操作（多行代码）通过点号(.)链接在一起成为一句代码,使代码可读性好a(1).b(2).c(3)。
//##------ 实现链式编程的两种形式：本质都是一样的，就是执行（getter）方法之后，得到一个block，block必须有返回值（本身对象），block参数（需要操作的值）
//1、声明方法: 缺点就是 Xcode提示不太友好。不推荐 声明方法的返回值是block,block必须有返回值（本身对象），block参数（需要操作的值）
//p.run() <=> [p run]();//执行方法的同时之后，立即执行方法返回的block
//2、声明属性: 本质就是利用他的getter方法
//声明属性，属性的类型是block，block必须有返回值（本身对象），block参数（需要操作的值）
//---------##
#import "kConst.h"
#import <Foundation/Foundation.h>
/**
 用于动态新增属性
 */
#import <objc/runtime.h>
NS_ASSUME_NONNULL_BEGIN
/*
// NSUnderlineStyleNone 不设置下划线／删除线
// NSUnderlineStyleSingle 设置下划线／删除线为细的单线
// NSUnderlineStyleThick 设置下划线／删除线为粗的单线
// NSUnderlineStyleDouble 设置下划线／删除线为细的双线
// NSUnderlinePatternSolid 设置下划线／删除线样式为连续的实线
// NSUnderlinePatternDot 设置下划线／删除线样式为点，也就是虚线，比如这样：－－－－－－
// NSUnderlinePatterDash 设置下划线／删除线样式为破折号，比如这样：—— —— ——
// NSUnderlinePatternDashDot 设置下划线／删除线样式为连续的破折号和点，比如这样：——－——－——－
// NSUnderlinePatternDashDotDot 设置下划线／删除线样式为连续的破折号、点、点，比如：——－－——－－——－－
// NSUnderlineByWord 在有空格的地方不设置下划线／删除线
*/
static const char leftMutableAttributedStringKey;
@interface NSMutableAttributedString (Chain)
/**
 记录最近一次新添加的富文本对应的字符串，以便进行后续的其他操作
 */
@property (strong, nonatomic) NSString *leftStr;
//每次kn_addString就是一句新的富文本
//kn_addString方法的返回值是block,block必须有返回值（本身对象），block参数（需要操作的值）
//富文本的block属性，发返回值就是自己，block的参数类型propertyPointerType
//k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_addString)
k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_addString)
//- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString; 直接声明方法也行
// 字体颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_fontColor)
// 字体大小
k_PropertyStatement(strong, NSMutableAttributedString, UIFont*, kn_fontSize);
// 字体背景颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_fontBgColor);
// 字体间距
k_PropertyStatement(assign, NSMutableAttributedString, NSInteger, kn_fontSpacing);
// 删除线
k_PropertyStatement(assign, NSMutableAttributedString, NSUnderlineStyle, kn_strikethrough);
// 删除线颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_strikethroughColor);
// 下划线
k_PropertyStatement(assign, NSMutableAttributedString, NSUnderlineStyle, kn_underline);
// 下划线颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_underlineColor);
// 笔画宽度 正值中空 负值填充
k_PropertyStatement(assign, NSMutableAttributedString, NSInteger, kn_strokeWidth);
// 笔画颜色
k_PropertyStatement(strong, NSMutableAttributedString, UIColor*, kn_strokeColor);
// 倾斜 正值右倾，负值左倾
k_PropertyStatement(assign, NSMutableAttributedString, CGFloat, kn_obliqueness);
// 书写方向
//@(NSWritingDirectionRightToLeft|NSWritingDirectionOverride)倒着写
k_PropertyStatement(strong, NSMutableAttributedString, NSArray*, kn_direction);
// 跳转URL
k_PropertyStatement(strong, NSMutableAttributedString, NSString*, kn_link);
// 图文混排等
k_PropertyStatement(strong, NSMutableAttributedString, NSTextAttachment*, kn_attachment);
// 段落属性
k_PropertyStatement(strong, NSMutableAttributedString, NSMutableParagraphStyle*, kn_paragraph);
@end
NS_ASSUME_NONNULL_END
1
2

NSMutableAttributedString+Chain.m

//
//  NSMutableAttributedString+Chain.m
//  ChainAttributedString
//
//  Created by mac on 2020/8/6.
//
#import "NSMutableAttributedString+Chain.h"
@implementation NSMutableAttributedString (Chain)
- (void)setLeftStr:(NSString *)leftStr{
    objc_setAssociatedObject(self, &leftMutableAttributedStringKey, leftStr, OBJC_ASSOCIATION_COPY);
}
- (NSString *)leftStr{
   return objc_getAssociatedObject(self, &leftMutableAttributedStringKey);
}
- (void)setKn_addString:(NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString{
}
- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_addString{
    return ^id(NSString *str){
        NSMutableAttributedString *attStr = [[NSMutableAttributedString alloc]initWithString:str];
        self.leftStr = str;
        [self appendAttributedString:attStr];
        return self;
    };
}
- (void)setKn_fontColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontColor{}
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSForegroundColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSForegroundColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_fontSize:(NSMutableAttributedString * _Nonnull (^)(UIFont * _Nonnull))kn_fontSize{};
- (NSMutableAttributedString * _Nonnull (^)(UIFont * _Nonnull))kn_fontSize{
    return ^id(UIFont *size) {
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSFontAttributeName value:size range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSFontAttributeName value:size range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_fontBgColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontBgColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_fontBgColor{
    return ^id(UIColor *bgColor){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSBackgroundColorAttributeName value:bgColor range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSBackgroundColorAttributeName value:bgColor range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_fontSpacing:(NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_fontSpacing{};
- (NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_fontSpacing{
    return ^id(NSInteger spacing){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSKernAttributeName value:@(spacing) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSKernAttributeName value:@(spacing) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strikethrough:(NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_strikethrough{};
- (NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_strikethrough{
    return ^id(NSUnderlineStyle style){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrikethroughStyleAttributeName value:@(style) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrikethroughStyleAttributeName value:@(style) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strikethroughColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strikethroughColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strikethroughColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrikethroughColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrikethroughColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_underline:(NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_underline{};
- (NSMutableAttributedString * _Nonnull (^)(NSUnderlineStyle))kn_underline{
    return ^id(NSUnderlineStyle style){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSUnderlineStyleAttributeName value:@(style) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSUnderlineStyleAttributeName value:@(style) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_underlineColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_underlineColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_underlineColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSUnderlineColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSUnderlineColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strokeWidth:(NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_strokeWidth{};
- (NSMutableAttributedString * _Nonnull (^)(NSInteger))kn_strokeWidth{
    return ^id(NSInteger width){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrokeWidthAttributeName value:@(width) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrokeWidthAttributeName value:@(width) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_strokeColor:(NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strokeColor{};
- (NSMutableAttributedString * _Nonnull (^)(UIColor * _Nonnull))kn_strokeColor{
    return ^id(UIColor *color){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSStrokeColorAttributeName value:color range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSStrokeColorAttributeName value:color range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_obliqueness:(NSMutableAttributedString * _Nonnull (^)(CGFloat))kn_obliqueness{};
- (NSMutableAttributedString * _Nonnull (^)(CGFloat))kn_obliqueness{
    return ^id(CGFloat obliqueness){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSObliquenessAttributeName value:@(obliqueness) range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSObliquenessAttributeName value:@(obliqueness) range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_direction:(NSMutableAttributedString * _Nonnull (^)(NSArray * _Nonnull))kn_direction{};
- (NSMutableAttributedString * _Nonnull (^)(NSArray * _Nonnull))kn_direction{
    return ^id(NSArray *direction){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSWritingDirectionAttributeName value:direction range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSWritingDirectionAttributeName value:direction range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_link:(NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_link{};
- (NSMutableAttributedString * _Nonnull (^)(NSString * _Nonnull))kn_link{
    return ^id(NSString *link){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSLinkAttributeName value:[NSURL URLWithString:link] range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSLinkAttributeName value:[NSURL URLWithString:link] range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
- (void)setKn_attachment:(NSMutableAttributedString * _Nonnull (^)(NSTextAttachment * _Nonnull))kn_attachment{}
- (NSMutableAttributedString * _Nonnull (^)(NSTextAttachment * _Nonnull))kn_attachment{
    return ^id(NSTextAttachment *attachment){
        NSAttributedString * imageStr = [NSAttributedString attributedStringWithAttachment:attachment];
        [self appendAttributedString:imageStr];
        return self;
    };
}
- (void)setKn_paragraph:(NSMutableAttributedString * _Nonnull (^)(NSMutableParagraphStyle * _Nonnull))kn_paragraph{};
- (NSMutableAttributedString * _Nonnull (^)(NSMutableParagraphStyle * _Nonnull))kn_paragraph{
    return ^id(NSMutableParagraphStyle *paragraph){
        if ([self.leftStr isEqualToString:@""]) {
            [self addAttribute:NSParagraphStyleAttributeName value:paragraph range:NSMakeRange(0, self.length)];
        }else{
            [self addAttribute:NSParagraphStyleAttributeName value:paragraph range:NSMakeRange(self.length-self.leftStr.length, self.leftStr.length)];
        }
        return self;
    };
}
@end
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

【封装富文本API，采用block实现链式编程】（block 的妙用：结合block和方法的优点实现iOS的链式编程）

文章目录

前言

核心思想

具体的实现步骤

I 、使用方法

II、实现细节

2.1 使用宏进行block属性的声明

2.2 代码

热门文章

最新文章

相关课程

相关电子书

相关实验场景